Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
tynevi committed Dec 19, 2014
1 parent 15d685a commit df04299
Showing 1 changed file with 1 addition and 28 deletions.
29 changes: 1 addition & 28 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,32 +2,5 @@

Thank you for your interest in [Azure.Microsoft.com](http://azure.microsoft.com) documentation!

## Ways to contribute

You can contribute to [Azure documentation](http://azure.microsoft.com/en-us/documentation/) in a few different ways:

* Contribute to a [forum discussion](http://social.msdn.microsoft.com/Forums/windowsazure/en-US/home).
* Submit Disqus comments at the bottom of articles.
* Contribute to articles via the public Azure repo.

## Repository organization

The content in the azure-content repository follows the organization of documentation on [Azure.Microsoft.com](http://azure.microsoft.com). This repository contains two root folders:

### \articles

The *\articles* folder contains the documentation articles formatted as markdown files with an *.md* extension. Articles are published to Azure.Microsoft.com in the path *http://azure.microsoft.com/en-us/documentation/articles/{article-name-without-md}/*.

* **Article filenames:** Begin with the service name, such as *hdinsight*, and include the development language and a description of the subject matter. Use all lowercase letters and dashes (-) to separate the words.

* **Media subfolders:** The *\articles* folder contains the *\media* folder, inside which are subfolders with the images for each article. The article image folders are named identically to the article file, minus the *.md* file extension.

### \includes

Content authors can create reusable content sections to be included into one or more articles. An include file is simple markdown (.md) file that can contain any valid markdown content including text, links, and images. All include markdown files must be contained in the *\includes* directory in the root of this repository.

* **Media subfolders:** The *\includes* folder contains a *\media* folder, inside which are folders for the images in each include. The includes image folders are named identically to the include file, minus the *.md* file extension.

## More guidance for contributors
For more guidance on contributing to articles on [Azure.Microsoft.com](http://azure.microsoft.com), see [CONTRIBUTING.md](https://github.com/Azure/azure-content/blob/master/CONTRIBUTING.md) in this repo.
For more guidance about how to contribute to our technical documentation at [Azure.Microsoft.com](http://azure.microsoft.com/documentation), see [CONTRIBUTING.md](https://github.com/Azure/azure-content/blob/master/CONTRIBUTING.md) in this repo.

0 comments on commit df04299

Please sign in to comment.