# Azure documentation issue guidance

Thanks for opening an issue in the Azure technical documentation repository. 

We use GitHub issues as the primary channel for customer and community feedback about the Azure documentation.

## Creating an issue

We prefer that you create documentation feedback issues using the Feedback link on the published article - the feedback control on the doc page creates an issue that contains all the article details so you can focus on the feedback part.

You can also create a feedback issue here in the repo. If you do this, please make sure your issue lists:

- [ ] The relevant Azure service or technology. 
- [ ] A link to the published documentation article that you have feedback about.
- [ ] Clear, specific feedback that the author can act on.

## Pull requests and article contributions

If you know the change that is needed in an article, we encourage you to submit the changes directly using a pull request. If the change is large, or if you want to contribute an entire article, follow these guidelines:

- [ ] Don't surprise us with a big pull request or a pull request with a new article! Submit an issue that describes the details of the proposed large change or new article. 
- [ ] Include the service or technology area.

We'll route the issue to the appropriate content team for review and discussion.

## Tech support and product feedback
If you would like to contact Microsoft about other things, such as product feedback or tech support, please review these guidelines:

- If you need technical support using Azure, the paid and free support options are described here: https://azure.microsoft.com/support/options/.

- Each article in the Azure technical documentation contains a product feedback button - it's best to submit product feedback directly from a relevant article. Otherwise, you can submit product feedback for most Azure products in the following product feedback forum: https://feedback.azure.com/d365community/forum/79b1327d-d925-ec11-b6e6-000d3a4f06a4.