|
| 1 | +## Index |
| 2 | +1. [Microsoft Open Source Code of Conduct](#microsoft-open-source-code-of-conduct) |
| 3 | +2. [Microsoft SQL Server Technical Documentation](#microsoft-sql-server-technical-documentation) |
| 4 | + * [Contribute to documentation](#contribute-to-documentation) |
| 5 | + + [Minor corrections](#minor-corrections) |
| 6 | + + [Larger submissions](#larger-submissions) |
| 7 | + * [Next steps](#next-steps) |
| 8 | + |
1 | 9 | ## Microsoft Open Source Code of Conduct |
2 | 10 |
|
3 | 11 | This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). |
4 | 12 | For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments. |
5 | 13 |
|
6 | | -# Microsoft Technical Documentation Contributor Guide |
7 | | -You've found the GitHub repository that houses the source for the technical documentation published on [https://docs.microsoft.com](https://docs.microsoft.com). |
| 14 | +# Microsoft SQL Server Technical Documentation |
8 | 15 |
|
9 | | -This repository also contains guidance to help you contribute to our technical documentation. For a list of the articles in the contributors' guide, see [the index](https://github.com/MicrosoftDocs/azure-docs/blob/master/contributor-guide/contributor-guide-index.md). |
| 16 | +You've found the GitHub repository that houses the source for the SQL Server technical documentation published on [https://docs.microsoft.com](https://docs.microsoft.com). |
10 | 17 |
|
11 | 18 | ## Contribute to documentation |
12 | 19 |
|
13 | | -* [Ways to contribute](#ways-to-contribute) |
14 | | -* [Code of conduct](#code-of-conduct) |
15 | | -* [About your contributions to content](#about-your-contributions-to-azure-content) |
16 | | -* [Repository organization](#repository-organization) |
17 | | -* [Use GitHub, Git, and this repository](#use-github-git-and-this-repository) |
18 | | -* [How to use markdown to format your topic](#how-to-use-markdown-to-format-your-topic) |
19 | | -* [More resources](#more-resources) |
20 | | -* [Index of all contributors' guide articles](contributor-guide/contributor-guide-index.md) (opens new page) |
21 | | - |
22 | | -## Ways to contribute |
23 | | - |
24 | | -* GitHub user interface. Either find the article in this repository, or visit the article on [https://docs.microsoft.com](https://docs.microsoft.com) and click the Edit link in upper right hand corner of the topic. That takes you to the the article file in GitHub. |
25 | | -* For substantial changes, adding or changing images, or contributing a new article, you need to fork this repository, install Git Bash, Markdown Pad, and learn some git commands. |
| 20 | +Anyone can submit changes to the SQL Server documentation. For more information, see [How to contribute to SQL Server Documentation](https://aka.ms/editsqldocs). |
26 | 21 |
|
27 | | -## About your contributions to content |
28 | 22 | ### Minor corrections |
29 | | -Minor corrections or clarifications you submit for documentation and code examples in this repo are covered by the [docs.microsoft.com Terms of Use](https://docs.microsoft.com/legal/termsofuse). |
| 23 | +Minor corrections or clarifications you submit for documentation and code examples in this repo are covered by the [docs.microsoft.com - Terms of Use](https://docs.microsoft.com/legal/termsofuse). |
30 | 24 |
|
31 | 25 | ### Larger submissions |
32 | 26 | If you submit a pull request with significant changes to documentation and code examples or new content, we'll send a comment in GitHub asking you to submit an online Contribution License Agreement (CLA) if you are not an employee of Microsoft. We need you to complete the online form before we can accept your pull request. |
33 | 27 |
|
34 | | -## Use GitHub, Git, and this repository |
35 | | -For information about how to contribute, how to use the GitHub user interface to contribute small changes, and how to fork and clone the repository for more significant contributions, see [Install and set up tools for authoring in GitHub](https://github.com/MicrosoftDocs/azure-docs/blob/master/contributor-guide/tools-and-setup.md). |
36 | | - |
37 | | -If you install GitBash and work locally, the steps for creating a new local working branch, making changes, and submitting the changes back to the main branch are listed in [Git commands for creating a new article or updating an existing article](https://github.com/MicrosoftDocs/azure-docs/blob/master/contributor-guide/git-commands-for-master.md) |
38 | | - |
39 | | -### Branches |
40 | | -Create local working branches that target a specific scope of change. Each branch should be limited to a single concept/article both to streamline work flow and reduce the possibility of merge conflicts. Appropriate scope for a new branch: |
41 | | - |
42 | | -* A new article (and associated images) |
43 | | -* Spelling and grammar edits on an article. |
44 | | -* Applying a single formatting change across a large set of articles (e.g. new copyright footer). |
45 | | - |
46 | | -## How to use markdown to format your topic |
47 | | -All the articles in this repository use GitHub flavored markdown. [Markdown basics](https://help.github.com/articles/getting-started-with-writing-and-formatting-on-github/) |
48 | | - |
49 | | - |
50 | | -## Article metadata |
51 | | -Article metadata enables certain functionalities such as author and contributor attribution, breadcrumbs, article descriptions, and SEO optimizations as well as reporting Microsoft uses to evaluate content performance. [Here's the guidance for making sure your metadata is done right](contributor-guide/article-metadata.md). |
52 | | - |
53 | | -### Labels |
54 | | -Automated labels are assigned to pull requests to help us manage the pull request workflow and to help let you know what's going on with your pull request: |
55 | | - |
56 | | -* Contribution License Agreement related |
57 | | - * cla-not-required: The change is relatively minor and does not require that you sign a CLA. |
58 | | - * cla-required: The scope of the change is relatively large and requires that you sign a CLA. |
59 | | - * cla-signed: The contributor signed the CLA, so the pull request can now move forward for review. |
60 | | -* Pillar labels: Labels such as PnP, Modern Apps, and TDC help categorize the pull requests by the internal organization that needs to review the pull request. |
61 | | -* Change sent to author: The author has been notified of the pending pull request. |
| 28 | +## Next steps |
62 | 29 |
|
63 | | -## More resources |
64 | | -See the [index of our contributor's guide](https://github.com/MicrosoftDocs/azure-docs/blob/master/contributor-guide/contributor-guide-index.md) for all our guidance topics. |
| 30 | +Explore the following resources: |
65 | 31 |
|
| 32 | +- [How to contribute to SQL Server Documentation](https://aka.ms/editsqldocs) |
| 33 | +- [SQL Server documentation home](https://docs.microsoft.com/sql/index) |
0 commit comments