Skip to content

Commit c3bbafc

Browse files
authored
feat: update support statement and references (#2118)
1 parent df2d080 commit c3bbafc

4 files changed

Lines changed: 46 additions & 18 deletions

File tree

docs/content/contributing/q-and-a.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -180,7 +180,7 @@ During initial module development module owners/developers need to use your own
180180

181181
### I'm already using a module today, but its missing a feature, what should I do?
182182

183-
You should use GitHub issues to propose changes or improvements for specific module. Issue request will be router to module owner that **MUST** respond to logged issues within 3 business days. In case that module currently don't have owner, [AVM Core Team]({{% siteparam base %}}/specs/shared/team-definitions/#avm-core-team) will handle request.
183+
You should use GitHub issues to propose changes or improvements for specific module. Issue request will be routed to module owner that **MUST** respond to logged issues as per the defined [support statement]({{% siteparam base %}}/help-support/module-support/#support-statements). In case that module currently don't have owner, [AVM Core Team]({{% siteparam base %}}/specs/shared/team-definitions/#avm-core-team) will handle request.
184184

185185
---
186186

docs/content/help-support/module-support.md

Lines changed: 38 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3,42 +3,64 @@ title: Module Support
33
description: Module Support for the Azure Verified Modules (AVM) program
44
---
55

6-
As mentioned on the [Introduction]({{% siteparam base %}}/overview/introduction) page, we understand that long-term support from Microsoft in an initiative like AVM is critical to its adoption by consumers and therefore the success of AVM. Therefore we have aligned and provide the below support statement/process for AVM modules.
6+
{{% notice style="warning" title="Recent Changes to Support Statements" %}}
77

8-
## Support Mechanism
8+
The AVM support statements and targets have been updated as of **June 2025**. To understand the changes, please review the below updates on this page.
99

10-
Azure Verified Modules are supported by the AVM teams, as defined [here]({{% siteparam base %}}/specs/shared/team-definitions/), using GitHub issues in the following order of precedence:
10+
For more information and reasoning behind the changes, please refer to the blog post we published on this topic: [Tech Community: Azure Verified Modules: Support Statement & Target Response Times Update](https://techcommunity.microsoft.com/blog/azuretoolsblog/azure-verified-modules-support-statement--target-response-times-update/4421489)
1111

12-
1. Module owners/contributors
13-
2. If there is no response within 3 business days, then the AVM core team will step in by:
14-
- First attempting to contact the module owners/contributors to prompt them to act.
15-
- If there is no response within a further 24 hours (on business days), the AVM core team will take ownership, triage, and provide a response within a further 2 business days.
16-
3. In the event of a security issue being unaddressed after 5 business days, escalation to the product group (Bicep/Terraform) to assist the AVM core team, will occur to provide additional support towards resolution; if required.
12+
{{% /notice %}}
1713

18-
All of this will be automated via the use of the Resource Management feature of the [Microsoft GitHub Policy Service](https://github.com/apps/microsoft-github-policy-service) and GitHub Actions, where possible and appropriate.
14+
As mentioned on the [Introduction]({{% siteparam base %}}/overview/introduction) page, we understand that long-term support from Microsoft in an initiative like AVM is critical to its adoption by consumers and therefore the success of AVM. Therefore we have aligned and provide the below support statement/process for AVM modules:
1915

20-
{{% notice style="note" %}}
16+
## Support Statements
2117

22-
Please note that the durations stated above are for a reasonable and useful response towards resolution of the issue raised, if possible, and **not** for a fix within these durations; although if possible this will of course happen.
18+
{{% notice style="info" %}}
19+
20+
Module owners do go on holiday or have periods of leave from time to time, during these times the AVM core team will attempt to triage issues based on the below on behalf of module owners. 👍
21+
22+
{{% /notice %}}
23+
24+
### For bugs/security issues
25+
26+
- 5 business days for a triage, meaningful response, and ETA to be provided for fix/resolution by module owner (which could be past the 5 days)
27+
- For issues that breach the 5 business days, the AVM core team will be notified and will attempt to respond to the issue within an additional 5 business days to assist in triage.
28+
- For security issues, the Bicep or Terraform Product Groups may step in to resolve security issues, if unresolved, after a further additional 5 business days.
29+
30+
### For feature requests
31+
32+
- 15 business days for a meaningful response and initial triage to understand the feature request. An ETA may be provided by the module owner if possible.
33+
34+
{{% notice style="caution" title="AVM is Open-Source" %}}
35+
36+
AVM is open-source, therefore, contributions are welcome via Pull Requests or comments in Issues from anyone in the world at any time on any Pull Request or Issues to assist AVM module owners 🌐
37+
38+
Review the [contribution guidance]({{% siteparam base %}}/contributing) to get involved!
2339

2440
{{% /notice %}}
2541

26-
{{% notice style="important" %}}
42+
{{% notice style="info" %}}
43+
44+
All of this will be automated via the use of the Resource Management feature of the [Microsoft GitHub Policy Service](https://github.com/apps/microsoft-github-policy-service) and GitHub Actions, where possible and appropriate.
45+
46+
{{% /notice %}}
2747

28-
Issues with an AVM module should be raised on the repo they are hosted on, not the AVM Central (`Azure/Azure-Verified-Modules`) repo!
48+
{{% notice style="note" %}}
2949

30-
*Not an issue if you raise in the wrong place, we will transfer it to it's correct home 👍*
50+
Please note that the durations stated above are for a reasonable and useful response towards resolution of the issue raised, if possible, and **not** for a fix within these durations; although if possible this will of course happen.
3151

3252
{{% /notice %}}
3353

34-
{{% notice style="important" %}}
54+
{{% notice style="tip" %}}
3555

3656
Issues that are likely related to an AVM module should be directly submitted on the module's GitHub repository as an "*AVM - Module Issue*". To identify the correct code repository, see the AVM [module indexes]({{% siteparam base %}}/indexes).
3757

38-
If an issue is likely related to the Azure platform, its APIs or configuration, script or programming languages, etc., you need to raise a ticket with Microsoft CSS (Microsoft Customer Services & Support) where your ticket will be triaged for any platform issues. If deemed a platform issue, the ticket will be addressed accordingly. In case it's deemed not a platform but a module issue, you will be redirected to submit a module issue on GitHub.
58+
If an issue is likely related to the Azure platform, its APIs or configuration, script or programming languages, etc., you need to [raise a ticket with Microsoft CSS (Microsoft Customer Services & Support)](https://azure.microsoft.com/support/create-ticket) where your ticket will be triaged for any platform issues. If deemed a platform issue, the ticket will be addressed accordingly. In case it's deemed not a platform but a module issue, you will be redirected to submit a module issue on GitHub.
3959

4060
{{% /notice %}}
4161

62+
---
63+
4264
## Orphaned Modules
4365

4466
Modules that have to have the AVM core team or Product Groups step in due to the module owners/contributors not responding, the AVM module will become "orphaned"; see [Module Lifecycle]({{% siteparam base %}}/specs/shared/module-lifecycle/) for more info.

docs/content/resources/faq.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -331,6 +331,12 @@ However, it is important to note that this does not mean that the modules cannot
331331

332332
---
333333

334+
### Why did the AVM team change the support statements and targets in June 2025?
335+
336+
The AVM team has updated the support statements and targets to better align with the current state of the AVM initiative and to ensure that module owners can provide meaningful responses and resolutions to issues raised by consumers. The changes were made to improve clarity, set realistic expectations, and enhance the overall support experience for AVM modules and their consumers.
337+
338+
More information about the changes can be found in the blog post, [Tech Community: Azure Verified Modules: Support Statement & Target Response Times Update](https://techcommunity.microsoft.com/blog/azuretoolsblog/azure-verified-modules-support-statement--target-response-times-update/4421489), we published on this topic.
339+
334340
## Technical questions
335341

336342
### Should pattern modules leverage resource modules? What if (some of) the required resource modules are not available?

docs/content/specs-defs/includes/shared/shared/non-functional/SNFR11.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,4 +21,4 @@ priority: 1140
2121

2222
## ID: SNFR11 - Category: Contribution/Support - Issues Response Times
2323

24-
A module owner **MUST** respond to logged issues within 3 business days. See [Module Support]({{% siteparam base %}}/help-support/module-support/) for more information.
24+
A module owner **MUST** respond to logged issues as defined in the [support statement]({{% siteparam base %}}/help-support/module-support/#support-statements). See [Module Support]({{% siteparam base %}}/help-support/module-support/) for more information.

0 commit comments

Comments
 (0)