Merge branch 'main' into patch-1

Author: subatoi

.devcontainer/Dockerfile

@@ -3,19 +3,3 @@
 # [Choice] Node.js version
 ARG VARIANT="dev-22-bullseye"
 FROM mcr.microsoft.com/devcontainers/javascript-node:${VARIANT}
-
-# [Optional] Uncomment this section to install additional OS packages.
-# RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
-#     && apt-get -y install --no-install-recommends <your-package-list-here>
-
-# [Optional] Uncomment if you want to install an additional version of node using nvm
-# ARG EXTRA_NODE_VERSION=10
-# RUN su node -c "source /usr/local/share/nvm/nvm.sh && nvm install ${EXTRA_NODE_VERSION}"
-
-# [Optional] Uncomment if you want to install more global node modules
-# RUN su node -c "npm install -g <your-package-list-here>"
-
-# Install the GitHub CLI see:
-# https://github.com/microsoft/vscode-dev-containers/blob/3d59f9fe37edb68f78874620f33dac5a62ef2b93/script-library/docs/github.md
-COPY library-scripts/github-debian.sh /tmp/library-scripts/
-RUN apt-get update && bash /tmp/library-scripts/github-debian.sh

.devcontainer/devcontainer.json

@@ -11,7 +11,8 @@
 
   // Install features. Type 'feature' in the VS Code command palette for a full list.
   "features": {
-    "sshd": "latest"
+    "sshd": "latest",
+    "ghcr.io/devcontainers/features/github-cli:1": {}
   },
 
   "customizations": {
@@ -53,17 +54,21 @@
 
   "portsAttributes": {
     "4000": {
-      "label": "Preview"
+      "label": "Review"
     }
   },
 
-  // Use 'postCreateCommand' to run commands after the container is created.
-  "postCreateCommand": "npm ci",
+  // Lifecycle commands
+  "onCreateCommand": "npm ci",
+  "postStartCommand": "nohup bash -c 'npm start &'",
+  // Set the port to be public
+  "postAttachCommand": "gh cs ports visibility 4000:public -c \"$CODESPACE_NAME\"",
 
   // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root.
   "remoteUser": "node",
 
   "hostRequirements": {
-    "memory": "8gb"
+    "memory": "16gb",
+    "cpus": "4"
   }
 }

.devcontainer/library-scripts/github-debian.sh

@@ -6,7 +6,6 @@ contributing/
 docs/
 node_modules/
 tests/
-# Folder is cloned during the preview + prod workflows, the assets are merged into other locations for use before the build
+# Folder is cloned during the Dockerfile build
 docs-early-access/
-# During the preview deploy untrusted user code may be cloned into this directory
-user-code/
+README.md

.dockerignore

@@ -13,7 +13,7 @@ Use the table of contents icon <img alt="Table of contents icon" src="/contribut
 To get an overview of the project, read the [README](../README.md) file. Here are some resources to help you get started with open source contributions:
 
 - [Finding ways to contribute to open source on GitHub](https://docs.github.com/en/get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github)
-- [Set up Git](https://docs.github.com/en/get-started/getting-started-with-git/set-up-git)
+- [Set up Git](https://docs.github.com/en/get-started/git-basics/set-up-git)
 - [GitHub flow](https://docs.github.com/en/get-started/using-github/github-flow)
 - [Collaborating with pull requests](https://docs.github.com/en/github/collaborating-with-pull-requests)
 

.github/CONTRIBUTING.md

@@ -4,18 +4,19 @@ Thank you for contributing to this project! You must fill out the information be
 
 ### Why:
 
-Closes:
+<!-- Paste the issue link or number here -->
+Closes: 
 
 <!-- If there's an existing issue for your change, please link to it above.
 If there's _not_ an existing issue, please open one first to make it more likely that this update will be accepted: https://github.com/github/docs/issues/new/choose. -->
 
 ### What's being changed (if available, include any code snippets, screenshots, or gifs):
 
 <!-- Let us know what you are changing. Share anything that could provide the most context.
-If you made changes to the `content` directory, a table will populate in a comment below with links to the preview and current production articles. -->
+If you made changes to the `content` directory, a table will populate in a comment below with links to the review and current production articles. -->
 
 ### Check off the following:
 
-- [ ] A subject matter expert (SME) has reviewed the technical accuracy of the content in this PR. In most cases, the author can be the SME. Open source contributions may require a SME review from GitHub staff.
+- [ ] A subject matter expert (SME) has reviewed the technical accuracy of the content in this PR. In most cases, the author can be the SME. Open source contributions may require an SME review from GitHub staff.
 - [ ] The changes in this PR meet [the docs fundamentals that are required for all content](http://docs.github.com/en/contributing/writing-for-github-docs/about-githubs-documentation-fundamentals).
-- [ ] All CI checks are passing and the changes look good in the preview environment.
+- [ ] All CI checks are passing and the changes look good in the review environment.

.github/PULL_REQUEST_TEMPLATE.md

@@ -8,7 +8,7 @@ runs:
   using: 'composite'
   steps:
     - name: Cache .next/cache
-      uses: actions/cache@13aacd865c20de90d75de3b17ebe84f7a17d57d2 # v4.0.0
+      uses: actions/cache@v4
       with:
         path: ${{ github.workspace }}/.next/cache
         # Generate a new cache whenever packages or source files change.

.github/actions/cache-nextjs/action.yml

@@ -10,19 +10,19 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - name: Clone Simplified Chinese
+    - name: Clone Spanish
       uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
       with:
-        repository: github/docs-internal.zh-cn
+        repository: github/docs-internal.es-es
         token: ${{ inputs.token }}
-        path: translations/zh-cn
+        path: translations/es-es
 
-    - name: Clone Spanish
+    - name: Clone Japanese
       uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
       with:
-        repository: github/docs-internal.es-es
+        repository: github/docs-internal.ja-jp
         token: ${{ inputs.token }}
-        path: translations/es-es
+        path: translations/ja-jp
 
     - name: Clone Portuguese
       uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
@@ -31,19 +31,19 @@ runs:
         token: ${{ inputs.token }}
         path: translations/pt-br
 
-    - name: Clone Russian
+    - name: Clone Simplified Chinese
       uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
       with:
-        repository: github/docs-internal.ru-ru
+        repository: github/docs-internal.zh-cn
         token: ${{ inputs.token }}
-        path: translations/ru-ru
+        path: translations/zh-cn
 
-    - name: Clone Japanese
+    - name: Clone Russian
       uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
       with:
-        repository: github/docs-internal.ja-jp
+        repository: github/docs-internal.ru-ru
         token: ${{ inputs.token }}
-        path: translations/ja-jp
+        path: translations/ru-ru
 
     - name: Clone French
       uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
@@ -52,16 +52,16 @@ runs:
         token: ${{ inputs.token }}
         path: translations/fr-fr
 
-    - name: Clone German
+    - name: Clone Korean
       uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
       with:
-        repository: github/docs-internal.de-de
+        repository: github/docs-internal.ko-kr
         token: ${{ inputs.token }}
-        path: translations/de-de
+        path: translations/ko-kr
 
-    - name: Clone Korean
+    - name: Clone German
       uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
       with:
-        repository: github/docs-internal.ko-kr
+        repository: github/docs-internal.de-de
         token: ${{ inputs.token }}
-        path: translations/ko-kr
+        path: translations/de-de

.github/actions/clone-translations/action.yml

@@ -0,0 +1,39 @@
+name: Get changed files
+description: Get a list of changed files
+
+inputs:
+  files:
+    description: 'Files or directories to check for changes, supports names, directories, trailing slashes, and single trailing wildcard'
+    required: false
+    default: '.'
+  head:
+    description: 'Head ref to check for changes against'
+    required: false
+  output_file:
+    description: 'Optional file path to write the changes to'
+    required: false
+
+outputs:
+  all_changed_files:
+    description: 'List of all changed files (unfiltered), includes removals'
+    value: ${{ steps.get_changes.outputs.all_changed_files }}
+  filtered_changed_files:
+    description: 'List of changed files matching the `files` filter, does not include removals'
+    value: ${{ steps.get_changes.outputs.filtered_changed_files }}
+  filtered_deleted_files:
+    description: 'List of deleted files matching the `files` filter'
+    value: ${{ steps.get_changes.outputs.filtered_deleted_files }}
+  filtered_renamed_files:
+    description: 'List of renamed files matching the `files` filter'
+    value: ${{ steps.get_changes.outputs.filtered_renamed_files }}
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Gather changed files
+      id: get_changes
+      env:
+        INPUT_HEAD: ${{ inputs.head || github.event.pull_request.head.ref || github.event.merge_group.head_ref ||  github.ref_name }}
+        INPUT_OUTPUT_FILE: ${{ inputs.output_file }}
+      shell: bash
+      run: ${{ github.action_path }}/get-changed-files.sh