work in progress
- Follow the structure used in the existing articles.
- Apply the file naming conventions that are used for the existing articles.
- Place all image files in an article-specific folder within the media folder.
- Include alt text for all images.
- Write for an international audience. This includes:
- Use short, simple sentences.
- Use active voice and imperative verbs where possible.
- Do not use emoticons, jargon, or slang in the code or articles.
- Use lists and tables instead of long paragraphs where possible.
- Avoid colloquialisms or region-specific language.
- Use optional pronouns and articles (that, who, the) for clarity.
- Include optional punctuation.
- Spell check and grammar check your document.
- For fictitious URLs, use www.example.com. For fictitious addresses, use http://myserver/.
For more authoring guidance, see https://github.com/Azure/azure-content/tree/master/contributor-guide.
We will review and approve all articles before we include them in this repository and potentially on MSDN and/or dev.office.com.