Merge pull request #812 from MicrosoftDocs/main

Main to live 8/8/23

.github/ISSUE_TEMPLATE/general-issue-template.md

@@ -1,6 +1,6 @@
 ---
 name: General issue template
-about: Use this template to report all feedback/issues for the Microsoft Learn documentation contributor guide.
+about: Use this template to report all feedback/issues for the Microsoft Learn contributor guide.
 title: ''
 labels: ''
 assignees: carlyrevier, jehchow
@@ -10,7 +10,7 @@ assignees: carlyrevier, jehchow
 ---
 **PLEASE READ AND THEN DELETE BEFORE SUBMITTING YOUR ISSUE**
 
-Welcome to the Microsoft Learn documentation contributor guide feedback form!
+Welcome to the Microsoft Learn contributor guide feedback form!
 
 Issues submitted here are reviewed by the repo managers of the contributor guide, **not product teams.** Your issue should pertain to the documentation in this [contributor guide](https://learn.microsoft.com/contribute) only. Requests for updates to products or product documentation will be closed.
 

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,6 +1,6 @@
 # Contributor guide pull request
 
-Thanks for contributing to the [Microsoft Learn documentation contributor guide](https://learn.microsoft.com/contribute/?branch=main). Please read these instructions for processing your pull request (PR). Once you've read this text, delete it and write a brief description of the changes you're proposing.
+Thanks for contributing to the [Microsoft Learn contributor guide](https://learn.microsoft.com/contribute/?branch=main). Please read these instructions for processing your pull request (PR). Once you've read this text, delete it and write a brief description of the changes you're proposing.
 
 ## Quality control
 

.openpublishing.redirection.json

@@ -34,6 +34,181 @@
             "source_path": "Contribute/dotnet-voice-tone.md",
             "redirect_url": "/contribute/dotnet/dotnet-voice-tone",
             "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/additional-resources.md",
+            "redirect_url": "/contribute/content/additional-resources",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/architecture-center/aac-contribute.md",
+            "redirect_url": "/contribute/content/architecture-center/aac-contribute",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/architecture-center/guide-templates.md",
+            "redirect_url": "/contribute/content/architecture-center/guide-templates",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/architecture-center/sample-solution-templates.md",
+            "redirect_url": "/contribute/content/architecture-center/sample-solution-templates",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/architecture-center/solution-idea-templates.md",
+            "redirect_url": "/contribute/content/architecture-center/solution-idea-templates",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/code-in-docs.md",
+            "redirect_url": "/contribute/content/code-in-docs",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/docs-authoring/dev-lang-completion.md",
+            "redirect_url": "/contribute/content/docs-authoring/dev-lang-completion",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/docs-authoring/image-compression.md",
+            "redirect_url": "/contribute/content/docs-authoring/image-compression",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/docs-authoring/jupyter-notebooks.md",
+            "redirect_url": "/contribute/content/docs-authoring/jupyter-notebooks",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/docs-authoring/metadata-explorer.md",
+            "redirect_url": "/contribute/content/docs-authoring/metadata-explorer",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/docs-authoring/metadata-updates.md",
+            "redirect_url": "/contribute/content/docs-authoring/metadata-updates",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/docs-authoring/reformat-table.md",
+            "redirect_url": "/contribute/content/docs-authoring/reformat-table",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/docs-authoring/smart-quote-replacement.md",
+            "redirect_url": "/contribute/content/docs-authoring/smart-quote-replacement",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/docs-authoring/sort-redirects.md",
+            "redirect_url": "/contribute/content/docs-authoring/sort-redirects",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/docs-authoring/sort-selection.md",
+            "redirect_url": "/contribute/content/docs-authoring/sort-selection",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/dotnet/dotnet-contribute-code-analysis.md",
+            "redirect_url": "/contribute/content/dotnet/dotnet-contribute-code-analysis",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/dotnet/dotnet-contribute.md",
+            "redirect_url": "/contribute/content/dotnet/dotnet-contribute",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/dotnet/dotnet-pr-review.md",
+            "redirect_url": "/contribute/content/dotnet/dotnet-pr-review",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/dotnet/dotnet-style-guide.md",
+            "redirect_url": "/contribute/content/dotnet/dotnet-style-guide",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/dotnet/dotnet-voice-tone.md",
+            "redirect_url": "/contribute/content/dotnet/dotnet-voice-tone",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/dotnet/labels-projects.md",
+            "redirect_url": "/contribute/content/dotnet/labels-projects",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/dotnet/net-core-5-naming.md",
+            "redirect_url": "/contribute/content/dotnet/net-core-5-naming",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/get-started-setup-github.md",
+            "redirect_url": "/contribute/content/get-started-setup-github",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/get-started-setup-local.md",
+            "redirect_url": "/contribute/content/get-started-setup-local",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/get-started-setup-tools.md",
+            "redirect_url": "/contribute/content/get-started-setup-tools",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/git-github-fundamentals.md",
+            "redirect_url": "/contribute/content/git-github-fundamentals",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/hacktoberfest.md",
+            "redirect_url": "/contribute/content/hacktoberfest",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/how-to-write-docs-auth-pack.md",
+            "redirect_url": "/contribute/content/how-to-write-docs-auth-pack",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/how-to-write-links.md",
+            "redirect_url": "/contribute/content/how-to-write-links",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/how-to-write-workflows-major.md",
+            "redirect_url": "/contribute/content/how-to-write-workflows-major",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/markdown-reference.md",
+            "redirect_url": "/contribute/content/markdown-reference",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/metadata.md",
+            "redirect_url": "/contribute/content/metadata",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/powershell-overview.md",
+            "redirect_url": "/contribute/content/powershell-overview",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/style-quick-start.md",
+            "redirect_url": "/contribute/content/style-quick-start",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "Contribute/text-formatting-guidelines.md",
+            "redirect_url": "/contribute/content/text-formatting-guidelines",
+            "redirect_document_id": true
         }
     ]
 }

Contribute/breadcrumb/toc.yml

@@ -1,7 +1,12 @@
+items:
 - name: Learn
   tocHref: /
   topicHref: /
   items:
-  - name: Documentation contributor guide
-    tocHref: /contribute/
-    topicHref: /contribute/
+  - name: Contribute
+    tocHref: /Contribute/
+    topicHref: /Contribute/index
+    items:
+    - name: Contributor guide
+      tocHref: /Contribute/content
+      topicHref: /Contribute/content

Contribute/TOC.yml → Contribute/content/TOC.yml

@@ -19,7 +19,7 @@
       displayName: alerts notes tips important caution warnings apostrophes quotation marks quotes blockquotes bold italic code snippets columns headings html images includes links lists bullets bulleted checklist numbered next steps button localize non-localized section selector superscript subscript table tables tabs tabbed videos icons
     - name: Style and voice quick start
       href: style-quick-start.md
-    - name: Style guide
+    - name: Microsoft Writing Style Guide
       href: /style-guide/
     - name: Add code to articles
       href: code-in-docs.md

Contribute/additional-resources.md → Contribute/content/additional-resources.md

@@ -24,7 +24,6 @@ If you are unfamiliar with Git or GitHub, these resources can help you learn, be
 ## GitHub resources
 
 - [15-minute interactive primer](https://try.github.io/): This is an online git tutorial. It exposes you to the basics of git.
-- [Cheat sheets](https://go.microsoft.com/fwlink/?linkid=853941): A quick reference to common GitHub commands and workflows.
 - [GitHub Guides](https://guides.github.com/): The home of GitHub documentation.
 - [GitHub learning resources](https://help.github.com/articles/git-and-github-learning-resources/): Other useful GitHub resources.
 - [GitHub training services](https://services.github.com/training/): A listing of tutorials and training offerings from GitHub.

Contribute/code-in-docs.md → Contribute/content/code-in-docs.md

@@ -665,6 +665,7 @@ The [Learn Authoring Pack](how-to-write-docs-auth-pack.md) includes a feature to
 | Go                             | `go`, `golang`                                                                 |
 | Golo                           | `golo`, `gololang`                                                             |
 | Gradle                         | `gradle`                                                                       |
+| GraphQL                        | `graphql`                                                                       |
 | Groovy                         | `groovy`                                                                       |
 | HTML                           | `html`, `xhtml`                                                                |
 | HTTP                           | `http`, `https`                                                                |

Contribute/dotnet/dotnet-contribute.md → Contribute/content/dotnet/dotnet-contribute.md

@@ -72,7 +72,7 @@ Code snippets are small, focused examples of code that demonstrate the concepts
 **Step 4:** Submit a pull request (PR) from your branch to the default branch.
 
 > [!IMPORTANT]
-> The [comment automation](../how-to-write-workflows-major.md#review-and-sign-off) functionality is not available on any of the .NET docs repositories at this time. Members of the .NET docs team will review and merge your PR.
+> The comment automation functionality is not available on any of the .NET docs repositories at this time. Members of the .NET docs team will review and merge your PR.
 
 Each PR should usually address one issue at a time, unless multiple issues are related to the same PR fix. The PR can modify one or multiple files. If you're addressing multiple fixes on different files, separate PRs are preferred.
 
@@ -250,7 +250,7 @@ The C# interactive experience changes how we work with snippets. Visitors can ru
 
 Contributions for Machine Translated (MT) content are currently not accepted. In an effort to improve the quality of MT content, we've transitioned to a Neural MT engine. We accept and encourage contributions for Human Translated (HT) content, which is used to train the Neural MT engine. So over time, contributions to HT content will improve the quality of both HT and MT. MT topics will have a disclaimer stating that part of the topic may be MT, and the **Edit** button won't be displayed, as editing is disabled.
 
-[!INCLUDE[note-docsitelocfeedback](../includes/note-docsitelocfeedback.md)]
+[!INCLUDE [note-docsitelocfeedback](../../includes/note-docsitelocfeedback.md)]
 
 ## Contributor license agreement
 

Contribute/get-started-setup-tools.md → Contribute/content/get-started-setup-tools.md

@@ -27,8 +27,15 @@ This install includes the Git version control system and Git Bash, the command-l
 
 ### Install Git client tools for Windows
 
-[!INCLUDE[Install Git client tools for Windows](~/guide/help-content/includes/proc-contribute-install-git-client-tools.md)]
+1. Download [Git for Windows](https://git-scm.com/download/win).
 
+1. Run the downloaded executable (.EXE) file and follow the prompts to install. Select **Next** at each prompt to accept all default settings.
+
+1. Select a code editor, when prompted. The default code editor is Vim.
+
+1. Select **Finish** to complete the installation.
+
+After installing Git for Windows, configure your Git name and your email address, and then install Visual Studio Code, as described below.
 
 ### Install Git client tools for Mac and Linux