Merge branch 'main' into main

janiceilene · web-flow · commit 00beada60555 · 2020-10-12T19:54:40.000-07:00
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,15 +1,13 @@
 <!--
-HUBBERS BEWARE! THE GITHUB/DOCS REPO IS PUBLIC TO THE ENTIRE INTERNET. OPEN AN ISSUE IN GITHUB/DOCS-CONTENT https://github.com/github/docs-content/issues/new/choose INSTEAD.
--->
-
-<!--
-Hello! Thanks for your interest in contributing to this project.
+Thank you for contributing to this project! You must fill out the information below before we can review this pull request. By explaining why you're making a change (or linking to a pull request) and what changes you've made, we can triage your pull request to the best possible team for review.
 
-Before opening a PR, please see our [CONTRIBUTING.md](https://github.com/github/docs/blob/main/CONTRIBUTING.md) for information how to contribute.
+See our [CONTRIBUTING.md](/main/CONTRIBUTING.md) for information how to contribute.
 
 For changes to content in [site policy](https://github.com/github/docs/tree/main/content/github/site-policy), see the [CONTRIBUTING guide in the site-policy repo](https://github.com/github/site-policy/blob/main/CONTRIBUTING.md).
 
-Thanks again! :octocat:
+We cannot accept changes to our translated content right now. See the [contributing.md](/main/CONTRIBUTING.md#earth_asia-translations) for more information.
+
+Thanks again!
 -->
 
 ### Why:
diff --git a/.github/allowed-actions.js b/.github/allowed-actions.js
@@ -15,6 +15,7 @@ module.exports = [
   'actions/setup-node@v1',
   'actions/setup-ruby@v1',
   'actions/stale@v3',
+  'crowdin/github-action@1.0.10',
   'dawidd6/action-delete-branch@v3',
   'docker://chinthakagodawita/autoupdate-action:v1',
   'github/codeql-action/analyze@v1',
diff --git a/.github/workflows/crowdin.yml b/.github/workflows/crowdin.yml
@@ -0,0 +1,50 @@
+# Please ping @github/docs-localization in the PR whenever you update this file!
+
+name: Crowdin Sync
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  sync_with_crowdin:
+    name: Sync with Crowdin
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - name: Sync
+        uses: crowdin/github-action@1.0.10
+        with:
+          upload_translations: true
+          download_translations: true
+          create_pull_request: true
+          
+          # Using a custom config temporarily to avoid clobbering the existing crowdin.yml
+          # that is used by the github-help-docs OAuth integration.
+          config: 'crowdin-actions-config.yml'
+
+          # This is the name of the git branch that Crowdin will create when opening a pull request.
+          # This branch does NOT need to be manually created. It will be created automatically by the action.
+          localization_branch_name: automated-crowdin-translations
+
+          # This is the name of the top-level directory that Crowdin will use for files.
+          # Note that this is not a "branch" in the git sense, but more like a top-level directory in your Crowdin project.
+          # This branch does NOT need to be manually created. It will be created automatically by the action.
+          crowdin_branch_name: crowdin-main
+
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+          # This is a numeric id, not to be confused with Crowdin API v1 "project identifier" string
+          # See "API v2" on https://crowdin.com/project/<your-project>/settings#api
+          CROWDIN_PROJECT_ID: ${{ secrets.CROWDIN_PROJECT_ID }}
+          
+          # A personal access token, not to be confused with Crowdin API v1 "API key"
+          # See https://crowdin.com/settings#api-key to generate a token
+          # This token was created by logging into Crowdin with the octoglot user
+          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
+
+          
diff --git a/README.md b/README.md
@@ -123,16 +123,12 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
     <td align="center"><a href="https://github.com/ruth"><img src="https://avatars0.githubusercontent.com/u/85029?v=4?s=64" width="64px;" alt=""/><br /><sub><b>Ruth</b></sub></a><br /><a href="#content-Ruth" title="Content">🖋</a></td>
     <td align="center"><a href="http://tomaszwisniewski.com"><img src="https://avatars2.githubusercontent.com/u/12593852?v=4?s=64" width="64px;" alt=""/><br /><sub><b>Tomasz Wisniewski</b></sub></a><br /><a href="https://github.com/github/docs/commits?author=wi5nia" title="Documentation">📖</a></td>
     <td align="center"><a href="https://chiedojohn.com/"><img src="https://avatars2.githubusercontent.com/u/2156688?v=4?s=64" width="64px;" alt=""/><br /><sub><b>Chiedo John</b></sub></a><br /><a href="https://github.com/github/docs/commits?author=chiedo" title="Code">💻</a></td>
+    
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/BenJam"><img src="https://avatars2.githubusercontent.com/u/158833?v=4" width="64px;" alt=""/><br /><sub><b>Benjamin Nickolls</b></sub></a><br /><a href="https://github.com/github/docs/commits?author=BenJam" title="Documentation">📖</a></td>
-    <td align="center"><a href="https://mcaffer.com"><img src="https://avatars2.githubusercontent.com/u/10070956?v=4" width="64px;" alt=""/><br /><sub><b>Jeff McAffer</b></sub></a><br /><a href="https://github.com/github/docs/commits?author=jeffmcaffer" title="Documentation">📖</a></td>
-    <td align="center"><a href="https://tjenkinson.me"><img src="https://avatars0.githubusercontent.com/u/3259993?v=4" width="64px;" alt=""/><br /><sub><b>Tom Jenkinson</b></sub></a><br /><a href="https://github.com/github/docs/commits?author=tjenkinson" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/casals"><img src="https://avatars0.githubusercontent.com/u/785860?v=4" width="64px;" alt=""/><br /><sub><b>Arthur Casals</b></sub></a><br /><a href="#content-casals" title="Content">🖋</a> <a href="https://github.com/github/docs/commits?author=casals" title="Documentation">📖</a></td>
-    <td align="center"><a href="https://www.arangodb.com/"><img src="https://avatars3.githubusercontent.com/u/7819991?v=4" width="64px;" alt=""/><br /><sub><b>Simran</b></sub></a><br /><a href="https://github.com/github/docs/commits?author=Simran-B" title="Documentation">📖</a></td>
-    <td align="center"><a href="https://github.com/ruth"><img src="https://avatars0.githubusercontent.com/u/85029?v=4" width="64px;" alt=""/><br /><sub><b>Ruth</b></sub></a><br /><a href="#content-Ruth" title="Content">🖋</a></td>
-    <td align="center"><a href="http://tomaszwisniewski.com"><img src="https://avatars2.githubusercontent.com/u/12593852?v=4" width="64px;" alt=""/><br /><sub><b>Tomasz Wisniewski</b></sub></a><br /><a href="https://github.com/github/docs/commits?author=wi5nia" title="Documentation">📖</a></td>
+     <td align="center"><a href="https://www.arangodb.com/"><img src="https://avatars3.githubusercontent.com/u/7819991?v=4" width="64px;" alt=""/><br /><sub><b>Simran</b></sub></a><br /><a href="https://github.com/github/docs/commits?author=Simran-B" title="Documentation">📖</a></td>
   </tr>
+  
 </table>
 
 <!-- markdownlint-restore -->
diff --git a/assets/images/help/codespaces/choose-branch-vscode.png b/assets/images/help/codespaces/choose-branch-vscode.png
diff --git a/assets/images/help/codespaces/choose-repository-vscode.png b/assets/images/help/codespaces/choose-repository-vscode.png
diff --git a/assets/images/help/codespaces/create-codespace-vscode.png b/assets/images/help/codespaces/create-codespace-vscode.png
diff --git a/assets/images/help/codespaces/delete-codespace-vscode.png b/assets/images/help/codespaces/delete-codespace-vscode.png
diff --git a/content/admin/configuration/network-ports.md b/content/admin/configuration/network-ports.md
@@ -34,7 +34,7 @@ Application ports provide web application and Git access for end users.
 | 443 | HTTPS | Access to the web application and Git over HTTPS. |
 | 80 | HTTP | Access to the web application. All requests are redirected to the HTTPS port when SSL is enabled. |
 | 22 | SSH | Access to Git over SSH. Supports clone, fetch, and push operations to public and private repositories. |
-| 9418 | Git | Git protocol port supports clone and fetch operations to public repositories with unencrypted network communication. |
+| 9418 | Git | Git protocol port supports clone and fetch operations to public repositories with unencrypted network communication. {% data reusables.enterprise_installation.when-9418-necessary %} |
 
 {% data reusables.enterprise_installation.terminating-tls %}
 
diff --git a/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md b/content/github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code.md
@@ -10,7 +10,7 @@ versions:
 
 {% data reusables.codespaces.release-stage %}
 
-### Connecting the {% data variables.product.prodname_vs_codespaces %} extension to your {% data variables.product.prodname_dotcom %} account
+### Prerequisites
 
 Before you can develop in a codespace directly in {% data variables.product.prodname_vscode %}, you must configure the {% data variables.product.prodname_vs_codespaces %} extension to connect to your {% data variables.product.product_name %} account.
 
@@ -29,11 +29,27 @@ Before you can develop in a codespace directly in {% data variables.product.prod
 8. To authorize {% data variables.product.prodname_vscode %} to access your account on {% data variables.product.product_name %}, click **Allow**.
 9. Sign in to {% data variables.product.product_name %} to approve the extension.
 
-### Opening a codespace in {% data variables.product.prodname_vscode %}
+### Creating a codespace in {% data variables.product.prodname_vscode %}
 
-After you've connected your {% data variables.product.product_name %} account to the {% data variables.product.prodname_vs_codespaces %} extension, you can develop in a codespace that you created on {% data variables.product.product_name %} directly in {% data variables.product.prodname_vscode %}.
+After you connect your {% data variables.product.product_name %} account to the {% data variables.product.prodname_vs_codespaces %} extension, you can develop in a codespace that you created on {% data variables.product.product_name %} or in {% data variables.product.prodname_vscode %}.
+
+{% data reusables.codespaces.click-remote-explorer-icon-vscode %}
+2. Click the Add icon, then click **Create New Codespace**.
+![The Create new Codespace option in {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/create-codespace-vscode.png)
+3. Type, then click the repository's name you want to develop in.
+![Searching for repository to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/choose-repository-vscode.png)
+4. Click the branch you want to develop in.
+![Searching for a branch to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/choose-branch-vscode.png)
+
+### Opening a codespace in {% data variables.product.prodname_vscode %}
 
 {% data reusables.codespaces.click-remote-explorer-icon-vscode %}
 2. Under Codespaces, click the codespace you want to develop in.
 3. Click the Connect to Codespace icon.
  ![The Connect to Codespace icon in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png)
+
+### Deleting a codespace in {% data variables.product.prodname_vscode %}
+
+1. Under Codespaces, right-click the codespace you want to delete.
+2. In the drop-down menu, click **Delete Codespace**.
+![Deleting a codespace in {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/delete-codespace-vscode.png)
diff --git a/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md b/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning.md
@@ -140,7 +140,7 @@ To add one or more queries, add a `with: queries:` entry within the `uses: githu
 ``` yaml
 - uses: github/codeql-action/init@v1
   with:
-    - queries: COMMA-SEPARATED LIST OF PATHS
+    queries: COMMA-SEPARATED LIST OF PATHS
 ```
 
 You can also specify query suites in the value of `queries`. Query suites are collections of queries, usually grouped by purpose or language.
@@ -154,8 +154,8 @@ In the following example, the `+` symbol ensures that the specified additional q
 ``` yaml
 - uses: github/codeql-action/init@v1
   with:
-    - config-file: ./.github/codeql/codeql-config.yml
-    - queries: +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main
+    config-file: ./.github/codeql/codeql-config.yml
+    queries: +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main
 ```
 
 ### Using a custom configuration file
diff --git a/content/github/writing-on-github/autolinked-references-and-urls.md b/content/github/writing-on-github/autolinked-references-and-urls.md
@@ -45,7 +45,7 @@ References to a commit's SHA hash are automatically converted into shortened lin
 | Commit URL | https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) |
 | SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) |
 | User@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e)
-| Username/Repository@SHA | User/Repository@SHA: jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord/sheetsee.js@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) |
+| Username/Repository@SHA | jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord/sheetsee.js@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) |
 
 ### Custom autolinks to external resources
 
diff --git a/contributing/content-style-guide.md b/contributing/content-style-guide.md
@@ -346,7 +346,7 @@ Use clear, simple language that’s approachable and accessible for a wide range
 
 ## Word choice and terminology
 
-For general guidance and GitHub-specific terms, see “[Terminology](https://brand.github.com/content/terminology) in and “[Words that can be tricky](https://brand.github.com/content/grammar#words-that-can-be-tricky)” in GitHub’s Brand Guide. For more detailed guidance, see the “[A-Z word list](https://docs.microsoft.com/en-us/style-guide)” in Microsoft’s style guide.
+For general guidance and GitHub-specific terms, see “[Terminology](https://brand.github.com/content/terminology)” and “[Words that can be tricky](https://brand.github.com/content/grammar#words-that-can-be-tricky)” in GitHub’s Brand Guide. For more detailed guidance, see the “[A-Z word list](https://docs.microsoft.com/en-us/style-guide)” in Microsoft’s style guide.
 
 ### Abbreviations
 
diff --git a/crowdin-actions-config.yml b/crowdin-actions-config.yml
@@ -0,0 +1,25 @@
+files:
+  - source: /content/**/*.md
+    translation: /translations/%locale%/%original_path%/%original_file_name%
+    ignore: [
+      "/content/README.md"
+    ]
+  - source: /data/**/*.yml
+    translation: /translations/%locale%/%original_path%/%original_file_name%
+  - source: /data/**/*.md
+    translation: /translations/%locale%/%original_path%/%original_file_name%
+    ignore: [
+      "data/README.md",
+      "data/reusables/README.md",
+      "data/variables/product.yml",
+      "data/variables/README.md",
+      "data/graphql",
+      "data/products.yml"
+      ]
+
+# These end up as env vars used by the GitHub Actions workflow
+project_id_env: CROWDIN_PROJECT_ID
+api_token_env: CROWDIN_PERSONAL_TOKEN
+
+# https://support.crowdin.com/configuration-file-v3/#saving-directory-structure-on-server
+preserve_hierarchy: true
diff --git a/data/reusables/codespaces/use-visual-studio-features.md b/data/reusables/codespaces/use-visual-studio-features.md
@@ -1 +1 @@
-After you open a codespace, you can develop using {% data variables.product.prodname_vscode %}'s features, such as text editing, debugging, and Git commands. For more information, see the [{% data variables.product.prodname_vscode %} documentation](https://code.visualstudio.com/docs).
+You can edit code, debug, and use Git commands while developing in a codespace with {% data variables.product.prodname_vscode %}. For more information, see the [{% data variables.product.prodname_vscode %} documentation](https://code.visualstudio.com/docs).
diff --git a/data/reusables/enterprise_installation/necessary_ports.md b/data/reusables/enterprise_installation/necessary_ports.md
@@ -9,4 +9,4 @@
 | 1194/UDP | VPN | Secure replication network tunnel in high availability configuration. |
 | 8080 | HTTP    | Plain-text web based {% data variables.enterprise.management_console %}. *Not required unless SSL is disabled manually.* |
 | 8443 | HTTPS   | Secure web based {% data variables.enterprise.management_console %}. *Required for basic installation and configuration.* |
-| 9418 | Git     | Simple Git protocol port. Clone and fetch operations to public repositories only. *Unencrypted network communication.* |
+| 9418 | Git     | Simple Git protocol port. Clone and fetch operations to public repositories only. *Unencrypted network communication.* {% data reusables.enterprise_installation.when-9418-necessary %}  |
diff --git a/data/reusables/enterprise_installation/when-9418-necessary.md b/data/reusables/enterprise_installation/when-9418-necessary.md
@@ -0,0 +1 @@
+If you have enabled private mode on your instance, then opening this port is only required if you also enabled anonymous Git read access. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)."
