This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.
Repo for MSDN & TechNet Library Brazilian Portuguese-speaking community project (formerly known as MINITEL)
You've found the GitHub repository that houses the source for the technical documentation that is published to the Community Content Project.
You can contribute to the Community Content Project in a few different ways:
-
Contribute a full technical article. You can easily contribute to technical articles in the GitHub user interface.
-
Submit comments, suggestions, and/or improvements to articles.
-
If you are making substantial changes to an existing article, adding or changing images, or contributing a new article, you need to fork this repository, install Git management and authoring tools, and learn some git commands.
- VS Code Free download
- GitHub desktop
- You can accept the default settings.
New articles, corrections, or clarifications you submit for documentation in this repo are covered by the MSDN Terms of use and TechNet Terms of use.
To contribute to the Azure technical content, you'll need a GitHub account.
If you are a Microsoft contributor, you need to set up your GitHub account so you're clearly identified as a Microsoft employee. Set up your profile as follows:
- Profile picture: a picture of you (required)
- Name: your first and last name (required)
- Email: your Microsoft email address (optional)
- Company: Microsoft Corporation (required)
- Location: list your location (optional)
Every published technical article has a comment stream provided by the Disqus service.
If you are a Microsoft employee, and if you are the author of or a contributor to an article, you need to sign up for Disqus so you can participate in the comment stream for the article.
- Sign up for an account at http://www.disqus.com/
- Fill out your profile as follows:
- Full Name: your full name as displayed in your Microsoft address book listing, plus the bracketed info, which is your alias plus @MSFT. Format: First Last [alias@MSFT]
- Location: Your location
- Short Bio: Your title
If you only need or want to make textual updates to an existing article, you probably don't need to follow the rest of the steps. You can use GitHub's web-based markdown editor to submit your changes. Just click the GitHub link in the article you want to modify:
![] (./img/contributetogit.png)
Then, click the edit icon in the GitHub version of the article
![] (./img/editicon.png)
That opens the easy-to-use web editor that makes it easy to submit changes. You don't need to follow the other steps in this article.
The GitHub UI does support creation of new files and dragging and dropping images. However, when you work in the UI, managing branches can be confusing so we typically recommend you install the tools and learn the commands for creating and managing articles. If you want to use the UI, see:
For the following sorts of work, we strongly recommend you install and learn to use the tools:
- Making major changes to an article
- Creating and publishing a new article
- Adding new images or updating images
- Updating an article over a period of days without publishing changes each of those days
- Creating content for a release that has to go out on a certain day at a certain time
Anybody with a GitHub account can contribute to Community Content project through our public repository at https://github.com/Microsoft/CommunityDocs-ptbr. No special permissions are required.
- Hosts the articles for MSDN by topic
- Each folder contains an "img" folder for storing article media
- Hosts the articles for TechNet by topic
- Each folder contains an "img" folder for storing article media
All the articles in this repository use GitHub flavored markdown. Here's a list of resources.
Article metadata enables certain functionalities on the azure.microsoft.com web site, such as author attribution, contributor attribution, breadcrumbs, article descriptions, and SEO optimizations as well as reporting Microsoft uses to evaluate the performance of the content. So, the metadata is important! Once your article is ready to publishing, we will be adding the metadata to the head of the article.