diff --git a/.github/workflows/content-pipelines.yml b/.github/workflows/content-pipelines.yml index 4a1da7b36eda..96e640510cb7 100644 --- a/.github/workflows/content-pipelines.yml +++ b/.github/workflows/content-pipelines.yml @@ -91,6 +91,7 @@ jobs: fi - name: Run content pipeline update script + id: update env: GH_TOKEN: ${{ secrets.DOCS_BOT_PAT_BASE }} GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} @@ -133,27 +134,48 @@ jobs: GH_TOKEN: ${{ secrets.DOCS_BOT_PAT_BASE }} UPDATE_BRANCH: ${{ steps.branch.outputs.update_branch }} PIPELINE_ID: ${{ matrix.id }} + COMPARE_URL: ${{ steps.update.outputs.compare_url }} + SHORT_RANGE: ${{ steps.update.outputs.short_range }} run: | PR_NUMBER="${{ steps.check-pr.outputs.pr_number }}" PR_TITLE="docs: update ${PIPELINE_ID} content from source docs" - - PR_BODY="_GitHub Copilot generated this pull request._"$'\n\n' - PR_BODY+="> [!NOTE]"$'\n' - PR_BODY+="> This PR is **automatically generated** by the [content pipeline update workflow](${{ github.server_url }}/${{ github.repository }}/actions/workflows/content-pipelines.yml). Each run adds a new commit with any documentation changes detected."$'\n\n' - PR_BODY+="## What this does"$'\n\n' - PR_BODY+="Runs the \`content-pipeline-update\` agent (${PIPELINE_ID}) against the latest source docs and updates official articles under \`content/\` that have fallen out of sync."$'\n\n' - PR_BODY+="## Review"$'\n\n' - PR_BODY+="* Review each commit for accuracy — the agent uses AI, so spot-check important changes"$'\n' - PR_BODY+="* To adjust agent behavior, see [Modifying results](${{ github.server_url }}/${{ github.repository }}/blob/main/src/content-pipelines/README.md#modifying-results)"$'\n' - PR_BODY+="* Once satisfied, merge to keep docs up to date"$'\n' - PR_BODY+="* A new PR will be created on the next run if there are further changes" + NEW_ITEM="* [\`${SHORT_RANGE}\`](${COMPARE_URL})" if [ -n "$PR_NUMBER" ]; then - echo "PR #$PR_NUMBER already exists — new commit pushed" + echo "PR #$PR_NUMBER already exists — appending source changes to body" + + EXISTING_BODY=$(gh pr view "$PR_NUMBER" --json body --jq '.body') + + # Append a new bullet before the SOURCE_CHANGES end marker + # Uses bash parameter expansion for safe literal string replacement + MARKER="" + INSERTION="${NEW_ITEM}"$'\n' + INSERTION+="${MARKER}" + UPDATED_BODY="${EXISTING_BODY/$MARKER/$INSERTION}" + + gh pr edit "$PR_NUMBER" --body "$UPDATED_BODY" + echo "Ensuring PR #$PR_NUMBER is marked ready for review" gh pr ready "$PR_NUMBER" || echo "Unable to mark PR #$PR_NUMBER as ready (it may already be ready)" else echo "Creating new PR" + + PR_BODY="_GitHub Copilot generated this pull request._"$'\n\n' + PR_BODY+="> [!NOTE]"$'\n' + PR_BODY+="> This PR is **automatically generated** by the [content pipeline update workflow](${{ github.server_url }}/${{ github.repository }}/actions/workflows/content-pipelines.yml). Each run adds a new commit with any documentation changes detected."$'\n\n' + PR_BODY+="## What this does"$'\n\n' + PR_BODY+="Runs the \`content-pipeline-update\` agent (${PIPELINE_ID}) against the latest source docs and updates official articles under \`content/\` that have fallen out of sync."$'\n\n' + PR_BODY+="## Source changes"$'\n\n' + PR_BODY+="Changes in the source repo that triggered this update:"$'\n\n' + PR_BODY+=""$'\n' + PR_BODY+="${NEW_ITEM}"$'\n' + PR_BODY+=""$'\n\n' + PR_BODY+="## Review"$'\n\n' + PR_BODY+="* Review each commit for accuracy — the agent uses AI, so spot-check important changes"$'\n' + PR_BODY+="* To adjust agent behavior, see [Modifying results](${{ github.server_url }}/${{ github.repository }}/blob/main/src/content-pipelines/README.md#modifying-results)"$'\n' + PR_BODY+="* Once satisfied, merge to keep docs up to date"$'\n' + PR_BODY+="* A new PR will be created on the next run if there are further changes" + gh pr create \ --title "$PR_TITLE" \ --body "$PR_BODY" \ diff --git a/.github/workflows/reviewers-docs-engineering.yml b/.github/workflows/reviewers-docs-engineering.yml index 44b2ef8d4c7d..d9510db35d92 100644 --- a/.github/workflows/reviewers-docs-engineering.yml +++ b/.github/workflows/reviewers-docs-engineering.yml @@ -21,6 +21,7 @@ on: - 'src/**' - '!src/**.json' # So that Docs Engineering isn't reviewing automated pipeline data PRs - '!src/**.yml' # So that Docs Engineering isn't reviewing automated pipeline data PRs + - '!src/**.sha' # So that Docs Engineering isn't reviewing automated pipeline data PRs - '.github/**' - 'config/**' - '.devcontainer/**' diff --git a/content/get-started/accessibility/github-command-palette.md b/content/get-started/accessibility/github-command-palette.md index 2da3f760fd99..1b0e02a50adf 100644 --- a/content/get-started/accessibility/github-command-palette.md +++ b/content/get-started/accessibility/github-command-palette.md @@ -6,6 +6,8 @@ versions: shortTitle: GitHub Command Palette redirect_from: - /get-started/using-github/github-command-palette +category: + - Customize your experience --- {% data reusables.command-palette.beta-note %} diff --git a/content/get-started/accessibility/keyboard-shortcuts.md b/content/get-started/accessibility/keyboard-shortcuts.md index fd6ea7c09de7..0b3ef9118799 100644 --- a/content/get-started/accessibility/keyboard-shortcuts.md +++ b/content/get-started/accessibility/keyboard-shortcuts.md @@ -13,6 +13,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Customize your experience --- ## About keyboard shortcuts diff --git a/content/get-started/accessibility/managing-your-theme-settings.md b/content/get-started/accessibility/managing-your-theme-settings.md index 71fa78e5ac95..a4e4e453d754 100644 --- a/content/get-started/accessibility/managing-your-theme-settings.md +++ b/content/get-started/accessibility/managing-your-theme-settings.md @@ -12,6 +12,8 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-your-theme-settings - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-your-theme-settings shortTitle: Manage theme settings +category: + - Customize your experience --- For choice and flexibility in how and when you use {% data variables.product.github %}, you can configure theme settings to change how {% data variables.product.github %} looks to you. You can choose from themes that are light or dark, or you can configure {% data variables.product.github %} to follow your system settings. diff --git a/content/get-started/archiving-your-github-personal-account-and-public-repositories/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md b/content/get-started/archiving-your-github-personal-account-and-public-repositories/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md index 851aa6b3b3c7..b18cb4534a27 100644 --- a/content/get-started/archiving-your-github-personal-account-and-public-repositories/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md +++ b/content/get-started/archiving-your-github-personal-account-and-public-repositories/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md @@ -9,6 +9,8 @@ versions: fpt: '*' ghec: '*' shortTitle: GitHub Archive program +category: + - Set up your account on GitHub --- {% data reusables.repositories.about-github-archive-program %} For more information, see [AUTOTITLE](/repositories/archiving-a-github-repository/about-archiving-content-and-data-on-github#about-the-github-archive-program). diff --git a/content/get-started/archiving-your-github-personal-account-and-public-repositories/requesting-an-archive-of-your-personal-accounts-data.md b/content/get-started/archiving-your-github-personal-account-and-public-repositories/requesting-an-archive-of-your-personal-accounts-data.md index 21ee21c4f865..e9e099e90f4e 100644 --- a/content/get-started/archiving-your-github-personal-account-and-public-repositories/requesting-an-archive-of-your-personal-accounts-data.md +++ b/content/get-started/archiving-your-github-personal-account-and-public-repositories/requesting-an-archive-of-your-personal-accounts-data.md @@ -10,6 +10,8 @@ versions: fpt: '*' ghec: '*' shortTitle: Request account archive +category: + - Set up your account on GitHub --- {% data variables.product.github %} stores repository and profile metadata from your personal account's activity. You can export your personal account's data through your account settings on {% data variables.product.prodname_dotcom %} or with the User Migration API. diff --git a/content/get-started/exploring-projects-on-github/contributing-to-a-project.md b/content/get-started/exploring-projects-on-github/contributing-to-a-project.md index 7c0c404fd34c..081a75c4f3f5 100644 --- a/content/get-started/exploring-projects-on-github/contributing-to-a-project.md +++ b/content/get-started/exploring-projects-on-github/contributing-to-a-project.md @@ -9,6 +9,8 @@ versions: ghec: '*' redirect_from: - /get-started/quickstart/contributing-to-projects +category: + - Explore and contribute --- Contributing to a project on {% data variables.product.github %} is an essential skill for developers and collaborators working together to achieve shared goals. Whether you're fixing bugs, adding features, or improving documentation, the process of contributing ensures structured and efficient collaboration. diff --git a/content/get-started/exploring-projects-on-github/contributing-to-open-source.md b/content/get-started/exploring-projects-on-github/contributing-to-open-source.md index d7e6d85d66e6..d5389bbffa04 100644 --- a/content/get-started/exploring-projects-on-github/contributing-to-open-source.md +++ b/content/get-started/exploring-projects-on-github/contributing-to-open-source.md @@ -6,6 +6,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Contribute to open source +category: + - Explore and contribute --- In this article, you'll learn how to contribute to an open source project by working through an example. We'll guide you through making a contribution to the `github/docs` repository: familiarizing yourself with the repository, finding an area to contribute, making and submitting a pull request, and working with maintainers to get your changes accepted. diff --git a/content/get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github.md b/content/get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github.md index cf8c4568e89a..f3d635ffcaff 100644 --- a/content/get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github.md +++ b/content/get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github.md @@ -15,6 +15,8 @@ versions: fpt: '*' ghec: '*' shortTitle: Finding open source projects +category: + - Explore and contribute --- Open source software powers much of the technology you use daily, from the web browser on your screen to the [NASA Ingenuity helicopter that flew on Mars](https://github.com/readme/featured/nasa-ingenuity-helicopter). diff --git a/content/get-started/exploring-projects-on-github/following-organizations.md b/content/get-started/exploring-projects-on-github/following-organizations.md index 7c353ea9e411..7c86fadcfa5f 100644 --- a/content/get-started/exploring-projects-on-github/following-organizations.md +++ b/content/get-started/exploring-projects-on-github/following-organizations.md @@ -5,6 +5,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Explore and contribute --- {% data reusables.organizations.follow-organizations-beta %} diff --git a/content/get-started/exploring-projects-on-github/following-people.md b/content/get-started/exploring-projects-on-github/following-people.md index 626687cfa307..645ae23d4155 100644 --- a/content/get-started/exploring-projects-on-github/following-people.md +++ b/content/get-started/exploring-projects-on-github/following-people.md @@ -10,6 +10,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Explore and contribute --- ## About followers diff --git a/content/get-started/exploring-projects-on-github/saving-repositories-with-stars.md b/content/get-started/exploring-projects-on-github/saving-repositories-with-stars.md index b4578a6be4f3..b2a5f0a36bd9 100644 --- a/content/get-started/exploring-projects-on-github/saving-repositories-with-stars.md +++ b/content/get-started/exploring-projects-on-github/saving-repositories-with-stars.md @@ -14,6 +14,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Save repositories with stars +category: + - Explore and contribute --- You can search, sort, and filter your starred repositories and topics on your {% data variables.explore.your_stars_page %}. diff --git a/content/get-started/exploring-projects-on-github/using-github-copilot-to-explore-projects.md b/content/get-started/exploring-projects-on-github/using-github-copilot-to-explore-projects.md index 822f085e6968..5b42145521fd 100644 --- a/content/get-started/exploring-projects-on-github/using-github-copilot-to-explore-projects.md +++ b/content/get-started/exploring-projects-on-github/using-github-copilot-to-explore-projects.md @@ -4,6 +4,8 @@ intro: 'This guide will help you use {% data variables.product.prodname_copilot_ versions: feature: copilot shortTitle: Use Copilot to explore projects +category: + - Explore and contribute --- In this guide, you’ll learn how to use {% data variables.copilot.copilot_chat_dotcom_short %} to understand a repository’s purpose, examine files, and dive into specific lines of code. By following these steps, you’ll gain insights into any project faster—making onboarding, code review, and project exploration easier and more efficient. diff --git a/content/get-started/git-basics/about-remote-repositories.md b/content/get-started/git-basics/about-remote-repositories.md index f9371f708449..97b9da717d49 100644 --- a/content/get-started/git-basics/about-remote-repositories.md +++ b/content/get-started/git-basics/about-remote-repositories.md @@ -16,6 +16,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Work with Git --- ## About remote repositories diff --git a/content/get-started/git-basics/associating-text-editors-with-git.md b/content/get-started/git-basics/associating-text-editors-with-git.md index 0914f09c5dbb..f0d1b6218b9c 100644 --- a/content/get-started/git-basics/associating-text-editors-with-git.md +++ b/content/get-started/git-basics/associating-text-editors-with-git.md @@ -15,6 +15,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Associate text editors +category: + - Set up Git --- ## Using {% data variables.product.prodname_vscode %} as your editor diff --git a/content/get-started/git-basics/caching-your-github-credentials-in-git.md b/content/get-started/git-basics/caching-your-github-credentials-in-git.md index 4d440b7e9c34..b91178075917 100644 --- a/content/get-started/git-basics/caching-your-github-credentials-in-git.md +++ b/content/get-started/git-basics/caching-your-github-credentials-in-git.md @@ -14,6 +14,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Caching credentials +category: + - Set up Git --- > [!TIP] diff --git a/content/get-started/git-basics/configuring-git-to-handle-line-endings.md b/content/get-started/git-basics/configuring-git-to-handle-line-endings.md index b201cd9a6305..aae5138691bc 100644 --- a/content/get-started/git-basics/configuring-git-to-handle-line-endings.md +++ b/content/get-started/git-basics/configuring-git-to-handle-line-endings.md @@ -15,6 +15,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Handle line endings +category: + - Set up Git --- ## About line endings diff --git a/content/get-started/git-basics/git-cheatsheet.md b/content/get-started/git-basics/git-cheatsheet.md index e42d61edbcd9..cf2bdb7fb747 100644 --- a/content/get-started/git-basics/git-cheatsheet.md +++ b/content/get-started/git-basics/git-cheatsheet.md @@ -11,6 +11,8 @@ versions: ghes: '*' ghec: '*' intro: This Git cheat sheet is a time saver when you forget a command or don't want to use help in the CLI. +category: + - Work with Git --- Learning all available Git commands at once can be a daunting task. You can use [Git Cheat Sheets](https://training.github.com/) for a quick reference to frequently used commands. The "Using Git" cheat sheet is available in several languages. diff --git a/content/get-started/git-basics/git-workflows.md b/content/get-started/git-basics/git-workflows.md index 8fdcaca97f4d..71b6819186bd 100644 --- a/content/get-started/git-basics/git-workflows.md +++ b/content/get-started/git-basics/git-workflows.md @@ -12,5 +12,7 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Explore and contribute --- You can adopt the {% data variables.product.prodname_dotcom %} flow method to standardize how your team functions and collaborates on {% data variables.product.prodname_dotcom %}. For more information, see [AUTOTITLE](/get-started/using-github/github-flow). diff --git a/content/get-started/git-basics/ignoring-files.md b/content/get-started/git-basics/ignoring-files.md index 3bba3c400c42..fe8c33dfa961 100644 --- a/content/get-started/git-basics/ignoring-files.md +++ b/content/get-started/git-basics/ignoring-files.md @@ -13,6 +13,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Work with Git --- ## Configuring ignored files for a single repository diff --git a/content/get-started/git-basics/managing-remote-repositories.md b/content/get-started/git-basics/managing-remote-repositories.md index e20b8908484a..3d5f84300db2 100644 --- a/content/get-started/git-basics/managing-remote-repositories.md +++ b/content/get-started/git-basics/managing-remote-repositories.md @@ -24,6 +24,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Manage remote repositories +category: + - Work with Git --- {% ifversion ghec %} diff --git a/content/get-started/git-basics/set-up-git.md b/content/get-started/git-basics/set-up-git.md index ab4e17148c42..4bc2c61d563f 100644 --- a/content/get-started/git-basics/set-up-git.md +++ b/content/get-started/git-basics/set-up-git.md @@ -19,6 +19,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Set up Git --- ## Using Git diff --git a/content/get-started/git-basics/setting-your-username-in-git.md b/content/get-started/git-basics/setting-your-username-in-git.md index fe04e8073571..d2c7aa644f72 100644 --- a/content/get-started/git-basics/setting-your-username-in-git.md +++ b/content/get-started/git-basics/setting-your-username-in-git.md @@ -12,6 +12,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Set your username +category: + - Set up Git --- ## About Git usernames diff --git a/content/get-started/git-basics/updating-credentials-from-the-macos-keychain.md b/content/get-started/git-basics/updating-credentials-from-the-macos-keychain.md index 8325039ad112..ae8a19ee3584 100644 --- a/content/get-started/git-basics/updating-credentials-from-the-macos-keychain.md +++ b/content/get-started/git-basics/updating-credentials-from-the-macos-keychain.md @@ -13,6 +13,8 @@ versions: ghes: '*' ghec: '*' shortTitle: macOS Keychain credentials +category: + - Set up Git --- > [!NOTE] diff --git a/content/get-started/git-basics/why-is-git-always-asking-for-my-credentials.md b/content/get-started/git-basics/why-is-git-always-asking-for-my-credentials.md index 082f34ab9a35..eda5afebb126 100644 --- a/content/get-started/git-basics/why-is-git-always-asking-for-my-credentials.md +++ b/content/get-started/git-basics/why-is-git-always-asking-for-my-credentials.md @@ -13,6 +13,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Repeated credential prompts +category: + - Set up Git --- Using an HTTPS remote URL has some advantages compared with using SSH. It's easier to set up than SSH, and usually works through strict firewalls and proxies. However, it also prompts you to enter your {% data variables.product.github %} credentials every time you pull or push a repository. diff --git a/content/get-started/index.md b/content/get-started/index.md index 0af4384be9a7..3ed2a442ebb1 100644 --- a/content/get-started/index.md +++ b/content/get-started/index.md @@ -24,29 +24,31 @@ versions: fpt: '*' ghes: '*' ghec: '*' -layout: product-landing +layout: discovery-landing introLinks: - quickstart: /get-started/start-your-journey -featuredLinks: - startHere: - - /get-started/start-your-journey/about-github-and-git - - /get-started/learning-about-github/githubs-plans - - /get-started/onboarding/getting-started-with-your-github-account - - /get-started/onboarding/getting-started-with-github-team - - /get-started/onboarding/getting-started-with-github-enterprise-cloud - - /get-started/onboarding/getting-started-with-github-enterprise-server - - /get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github - popular: + quickstart: /get-started/start-your-journey/hello-world + overview: /get-started/start-your-journey/about-github-and-git +carousels: + recommended: + - /get-started/start-your-journey + - /get-started/learning-to-code - /get-started/start-your-journey/creating-an-account-on-github - - /get-started/start-your-journey/hello-world - /get-started/git-basics/set-up-git - - /get-started/using-github-docs/about-versions-of-github-docs - - /get-started/learning-about-github/github-glossary - - /get-started/accessibility/keyboard-shortcuts - guideCards: - - /get-started/learning-about-github/types-of-github-accounts + - /get-started/start-your-journey/hello-world + - /get-started/onboarding/getting-started-with-your-github-account + - /get-started/learning-about-github/githubs-plans + - /get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github - /get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github - - /get-started/using-github/troubleshooting-connectivity-problems +includedCategories: + - Set up your account on GitHub + - Explore GitHub plans and features + - Set up Git + - Work with Git + - Explore and contribute + - Write and format content + - Share and reuse content + - Learn to code + - Customize your experience children: - /start-your-journey - /onboarding diff --git a/content/get-started/learning-about-github/about-github-advanced-security.md b/content/get-started/learning-about-github/about-github-advanced-security.md index fd17ecf89288..d11bfe514153 100644 --- a/content/get-started/learning-about-github/about-github-advanced-security.md +++ b/content/get-started/learning-about-github/about-github-advanced-security.md @@ -10,6 +10,8 @@ redirect_from: - /github/getting-started-with-github/about-github-advanced-security - /github/getting-started-with-github/learning-about-github/about-github-advanced-security shortTitle: GitHub Advanced Security +category: + - Explore GitHub plans and features --- ## About {% data variables.product.prodname_GHAS %} {% ifversion ghas-products %}products{% endif %} diff --git a/content/get-started/learning-about-github/access-permissions-on-github.md b/content/get-started/learning-about-github/access-permissions-on-github.md index 4a38e8e2a041..6f6d0f16df17 100644 --- a/content/get-started/learning-about-github/access-permissions-on-github.md +++ b/content/get-started/learning-about-github/access-permissions-on-github.md @@ -13,6 +13,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Access permissions +category: + - Explore GitHub plans and features --- ## About access permissions on {% data variables.product.github %} diff --git a/content/get-started/learning-about-github/faq-about-changes-to-githubs-plans.md b/content/get-started/learning-about-github/faq-about-changes-to-githubs-plans.md index 9e3912efed0c..777f0ed83730 100644 --- a/content/get-started/learning-about-github/faq-about-changes-to-githubs-plans.md +++ b/content/get-started/learning-about-github/faq-about-changes-to-githubs-plans.md @@ -8,6 +8,8 @@ redirect_from: - /github/getting-started-with-github/faq-about-changes-to-githubs-plans - /github/getting-started-with-github/learning-about-github/faq-about-changes-to-githubs-plans shortTitle: Changes to GitHub plans +category: + - Explore GitHub plans and features --- ## What plans and pricing changes did GitHub announce on April 14? diff --git a/content/get-started/learning-about-github/github-glossary.md b/content/get-started/learning-about-github/github-glossary.md index a3d3b22e3bbd..7e0a8b33440e 100644 --- a/content/get-started/learning-about-github/github-glossary.md +++ b/content/get-started/learning-about-github/github-glossary.md @@ -10,6 +10,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Explore GitHub plans and features --- {% for glossary in glossaries %} diff --git a/content/get-started/learning-about-github/github-language-support.md b/content/get-started/learning-about-github/github-language-support.md index 342de00e4858..d30441f21360 100644 --- a/content/get-started/learning-about-github/github-language-support.md +++ b/content/get-started/learning-about-github/github-language-support.md @@ -8,6 +8,8 @@ versions: redirect_from: - /github/getting-started-with-github/github-language-support - /github/getting-started-with-github/learning-about-github/github-language-support +category: + - Explore GitHub plans and features --- diff --git a/content/get-started/learning-about-github/githubs-plans.md b/content/get-started/learning-about-github/githubs-plans.md index 73124ffbd9b3..c40b14e59fb4 100644 --- a/content/get-started/learning-about-github/githubs-plans.md +++ b/content/get-started/learning-about-github/githubs-plans.md @@ -12,6 +12,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Explore GitHub plans and features --- ## About {% data variables.product.prodname_dotcom %}'s plans diff --git a/content/get-started/learning-about-github/types-of-github-accounts.md b/content/get-started/learning-about-github/types-of-github-accounts.md index 148e621710e8..957c1c2bfbae 100644 --- a/content/get-started/learning-about-github/types-of-github-accounts.md +++ b/content/get-started/learning-about-github/types-of-github-accounts.md @@ -13,6 +13,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Explore GitHub plans and features --- ## About accounts diff --git a/content/get-started/learning-to-code/developing-your-project-locally.md b/content/get-started/learning-to-code/developing-your-project-locally.md index c4173dbb9ec8..9633cd0f6e61 100644 --- a/content/get-started/learning-to-code/developing-your-project-locally.md +++ b/content/get-started/learning-to-code/developing-your-project-locally.md @@ -4,6 +4,8 @@ intro: 'Learn how to create a local development environment by working with an e versions: fpt: '*' shortTitle: Local development +category: + - Learn to code --- ## Overview diff --git a/content/get-started/learning-to-code/finding-and-fixing-your-first-code-vulnerability.md b/content/get-started/learning-to-code/finding-and-fixing-your-first-code-vulnerability.md index f4ceb82c7ce0..28388d2f7106 100644 --- a/content/get-started/learning-to-code/finding-and-fixing-your-first-code-vulnerability.md +++ b/content/get-started/learning-to-code/finding-and-fixing-your-first-code-vulnerability.md @@ -4,6 +4,8 @@ shortTitle: Secure your code intro: 'Learn the basics of securing your code by resolving a {% data variables.product.prodname_code_scanning %} alert in a demo repository.' versions: fpt: '*' +category: + - Learn to code --- As you're learning to code, it's normal to accidentally introduce vulnerabilities into your projects. If these security issues aren't addressed before you share your work, attackers can use them to manipulate your code and access sensitive data, so it's important to identify and patch them as soon as possible. diff --git a/content/get-started/learning-to-code/finding-and-fixing-your-first-dependency-vulnerability.md b/content/get-started/learning-to-code/finding-and-fixing-your-first-dependency-vulnerability.md index 5945a0b6ec79..e62859e9b03c 100644 --- a/content/get-started/learning-to-code/finding-and-fixing-your-first-dependency-vulnerability.md +++ b/content/get-started/learning-to-code/finding-and-fixing-your-first-dependency-vulnerability.md @@ -4,6 +4,8 @@ shortTitle: Secure your dependencies intro: 'Learn how to keep your dependencies secure by enabling {% data variables.product.prodname_dependabot %} and its features in a demo repository.' versions: fpt: '*' +category: + - Learn to code --- Using pre-written collections of code in your project, called **libraries** or **packages**, is common practice. These code modules save you a ton of time, letting you focus on the new, creative aspects of your work instead of coding large reusable components from scratch. When added to your project, they are called **dependencies**, since your work is dependent on the code they contain. diff --git a/content/get-started/learning-to-code/finding-and-understanding-example-code.md b/content/get-started/learning-to-code/finding-and-understanding-example-code.md index 042165956b62..f36f05b0b32b 100644 --- a/content/get-started/learning-to-code/finding-and-understanding-example-code.md +++ b/content/get-started/learning-to-code/finding-and-understanding-example-code.md @@ -4,6 +4,8 @@ shortTitle: Finding example code intro: "Improve your coding skills by learning from example code on {% data variables.product.github %}." versions: fpt: '*' +category: + - Learn to code --- ## How can I learn from code on {% data variables.product.github %}? diff --git a/content/get-started/learning-to-code/getting-feedback-on-your-code-from-github-copilot.md b/content/get-started/learning-to-code/getting-feedback-on-your-code-from-github-copilot.md index b9e38c1fdf8b..900d4d2d940a 100644 --- a/content/get-started/learning-to-code/getting-feedback-on-your-code-from-github-copilot.md +++ b/content/get-started/learning-to-code/getting-feedback-on-your-code-from-github-copilot.md @@ -4,6 +4,8 @@ shortTitle: Getting feedback on your code intro: "Learn how you can ask {% data variables.product.prodname_copilot %} to review your code changes and apply the suggested changes it creates." versions: fpt: '*' +category: + - Learn to code --- ## About coding collaboratively diff --git a/content/get-started/learning-to-code/getting-started-with-git.md b/content/get-started/learning-to-code/getting-started-with-git.md index 3aef4bf2553e..8b8818b6ef9e 100644 --- a/content/get-started/learning-to-code/getting-started-with-git.md +++ b/content/get-started/learning-to-code/getting-started-with-git.md @@ -4,6 +4,8 @@ intro: 'Learn the basics of Git by working through an example scenario.' versions: fpt: '*' shortTitle: Get started with Git +category: + - Learn to code --- Have you ever wished you had a time machine for your code? Well, Git is exactly that, and so much more! diff --git a/content/get-started/learning-to-code/index.md b/content/get-started/learning-to-code/index.md index 6b0b141759d2..2ce8da0d41a1 100644 --- a/content/get-started/learning-to-code/index.md +++ b/content/get-started/learning-to-code/index.md @@ -1,18 +1,34 @@ --- -title: Learning to code -intro: "Learn how {% data variables.product.github %} can help while you're learning to code." +title: Learn to code with GitHub Copilot +shortTitle: Learn to code +intro: "Learn how {% data variables.product.github %} and {% data variables.product.prodname_copilot_short %} can help you build programming skills, write better code, and ship secure projects." versions: fpt: '*' +layout: journey-landing +journeyTracks: + - id: 'learn_to_code_with_copilot' + title: 'Learn to code with GitHub Copilot' + description: 'Build programming skills from scratch using {% data variables.product.prodname_copilot_short %} as your coding assistant, then learn to write, debug, and secure your code.' + guides: + - href: '/get-started/learning-to-code/setting-up-copilot-for-learning-to-code' + - href: '/get-started/learning-to-code/getting-started-with-git' + - href: '/get-started/learning-to-code/finding-and-understanding-example-code' + - href: '/get-started/learning-to-code/reusing-other-peoples-code-in-your-projects' + - href: '/get-started/learning-to-code/developing-your-project-locally' + - href: '/get-started/learning-to-code/learning-to-debug-with-github-copilot' + - href: '/get-started/learning-to-code/getting-feedback-on-your-code-from-github-copilot' + - href: '/get-started/learning-to-code/storing-your-secrets-safely' + - href: '/get-started/learning-to-code/finding-and-fixing-your-first-code-vulnerability' + - href: '/get-started/learning-to-code/finding-and-fixing-your-first-dependency-vulnerability' children: + - /setting-up-copilot-for-learning-to-code - /getting-started-with-git - /finding-and-understanding-example-code - /reusing-other-peoples-code-in-your-projects - - /setting-up-copilot-for-learning-to-code - /developing-your-project-locally - /learning-to-debug-with-github-copilot - - /storing-your-secrets-safely - /getting-feedback-on-your-code-from-github-copilot + - /storing-your-secrets-safely - /finding-and-fixing-your-first-code-vulnerability - /finding-and-fixing-your-first-dependency-vulnerability -shortTitle: Learn to code --- diff --git a/content/get-started/learning-to-code/learning-to-debug-with-github-copilot.md b/content/get-started/learning-to-code/learning-to-debug-with-github-copilot.md index de39b761be76..630275a78d98 100644 --- a/content/get-started/learning-to-code/learning-to-debug-with-github-copilot.md +++ b/content/get-started/learning-to-code/learning-to-debug-with-github-copilot.md @@ -4,6 +4,8 @@ intro: 'Identify and fix errors in your code by asking {% data variables.product versions: fpt: '*' shortTitle: Debug with Copilot +category: + - Learn to code --- Finding and fixing bugs in code can be frustrating, especially when you're a new developer. Thankfully, tools like {% data variables.product.prodname_copilot %} can quickly identify and squash bugs, letting you focus on more creative, interesting work. diff --git a/content/get-started/learning-to-code/reusing-other-peoples-code-in-your-projects.md b/content/get-started/learning-to-code/reusing-other-peoples-code-in-your-projects.md index 12b1df37b93d..474c990f14e5 100644 --- a/content/get-started/learning-to-code/reusing-other-peoples-code-in-your-projects.md +++ b/content/get-started/learning-to-code/reusing-other-peoples-code-in-your-projects.md @@ -5,6 +5,8 @@ shortTitle: Reuse people's code versions: fpt: '*' allowTitleToDifferFromFilename: true +category: + - Learn to code --- One of the best things about open source software is the ability to reuse other people's code. Repurposing code helps you save time, discover new functionality, and learn other programming styles. There are two main ways to reuse code: diff --git a/content/get-started/learning-to-code/setting-up-copilot-for-learning-to-code.md b/content/get-started/learning-to-code/setting-up-copilot-for-learning-to-code.md index 49dabfdc5619..31596f6e8e68 100644 --- a/content/get-started/learning-to-code/setting-up-copilot-for-learning-to-code.md +++ b/content/get-started/learning-to-code/setting-up-copilot-for-learning-to-code.md @@ -4,6 +4,8 @@ intro: 'Configure {% data variables.product.prodname_copilot_short %} to help yo versions: fpt: '*' shortTitle: Set up Copilot for learning +category: + - Learn to code --- ## Can {% data variables.product.prodname_copilot_short %} help me learn to code? diff --git a/content/get-started/learning-to-code/storing-your-secrets-safely.md b/content/get-started/learning-to-code/storing-your-secrets-safely.md index 5fd950c6842b..a56ed9f11d2e 100644 --- a/content/get-started/learning-to-code/storing-your-secrets-safely.md +++ b/content/get-started/learning-to-code/storing-your-secrets-safely.md @@ -4,6 +4,8 @@ shortTitle: Storing secrets safely intro: "Learn about secrets in software development and how you can manage them safely." versions: fpt: '*' +category: + - Learn to code --- ## What is a secret? diff --git a/content/get-started/onboarding/getting-started-with-github-enterprise-cloud.md b/content/get-started/onboarding/getting-started-with-github-enterprise-cloud.md index 1b006b0ab9fd..7a85bde98947 100644 --- a/content/get-started/onboarding/getting-started-with-github-enterprise-cloud.md +++ b/content/get-started/onboarding/getting-started-with-github-enterprise-cloud.md @@ -4,6 +4,8 @@ intro: 'Get started with setting up and managing your enterprise account with {% versions: fpt: '*' ghec: '*' +category: + - Set up your account on GitHub --- ## About {% data variables.product.prodname_enterprise %} diff --git a/content/get-started/onboarding/getting-started-with-github-enterprise-server.md b/content/get-started/onboarding/getting-started-with-github-enterprise-server.md index 02fc968ce3e4..929fb8201785 100644 --- a/content/get-started/onboarding/getting-started-with-github-enterprise-server.md +++ b/content/get-started/onboarding/getting-started-with-github-enterprise-server.md @@ -3,6 +3,8 @@ title: Getting started with GitHub Enterprise Server intro: 'Get started with setting up and managing {% data variables.location.product_location %}.' versions: ghes: '*' +category: + - Set up your account on GitHub --- This guide will walk you through setting up, configuring and managing {% data variables.location.product_location %} as an enterprise administrator. diff --git a/content/get-started/onboarding/getting-started-with-github-team.md b/content/get-started/onboarding/getting-started-with-github-team.md index b694ba37b292..12454ea49e27 100644 --- a/content/get-started/onboarding/getting-started-with-github-team.md +++ b/content/get-started/onboarding/getting-started-with-github-team.md @@ -3,6 +3,8 @@ title: Getting started with GitHub Team intro: 'With {% data variables.product.prodname_team %} groups of people can collaborate across many projects at the same time in an organization account.' versions: fpt: '*' +category: + - Set up your account on GitHub --- This guide will walk you through setting up, configuring and managing your {% data variables.product.prodname_team %} account as an organization owner. diff --git a/content/get-started/onboarding/getting-started-with-the-github-enterprise-cloud-trial.md b/content/get-started/onboarding/getting-started-with-the-github-enterprise-cloud-trial.md index 199cf0ecaf57..e772ce771b24 100644 --- a/content/get-started/onboarding/getting-started-with-the-github-enterprise-cloud-trial.md +++ b/content/get-started/onboarding/getting-started-with-the-github-enterprise-cloud-trial.md @@ -4,6 +4,8 @@ intro: 'Set up the products available in your {% data variables.product.prodname versions: fpt: '*' ghec: '*' +category: + - Set up your account on GitHub --- This guide will walk you through setting up the products in your {% data variables.product.prodname_ghe_cloud %} trial, and provide you with the resources you need to get the most out of the trial. diff --git a/content/get-started/onboarding/getting-started-with-your-github-account.md b/content/get-started/onboarding/getting-started-with-your-github-account.md index 7bb0e21255ca..6d6e594383fa 100644 --- a/content/get-started/onboarding/getting-started-with-your-github-account.md +++ b/content/get-started/onboarding/getting-started-with-your-github-account.md @@ -5,6 +5,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Set up your account on GitHub --- This guide will walk you through setting up your {% data variables.product.company_short %} account and getting started with {% data variables.product.github %}'s features for collaboration and community. diff --git a/content/get-started/showcase-your-expertise-with-github-certifications/about-github-certifications.md b/content/get-started/showcase-your-expertise-with-github-certifications/about-github-certifications.md index 05aa15ec99d1..deecd31e8c10 100644 --- a/content/get-started/showcase-your-expertise-with-github-certifications/about-github-certifications.md +++ b/content/get-started/showcase-your-expertise-with-github-certifications/about-github-certifications.md @@ -4,6 +4,8 @@ intro: 'Earn a {% data variables.product.prodname_certifications_singular %} to allowTitleToDifferFromFilename: true versions: feature: github-certification +category: + - Explore GitHub plans and features --- {% ifversion ghec %} diff --git a/content/get-started/showcase-your-expertise-with-github-certifications/registering-for-a-github-certifications-exam.md b/content/get-started/showcase-your-expertise-with-github-certifications/registering-for-a-github-certifications-exam.md index c8b1ff3c9aab..2d5faed477dd 100644 --- a/content/get-started/showcase-your-expertise-with-github-certifications/registering-for-a-github-certifications-exam.md +++ b/content/get-started/showcase-your-expertise-with-github-certifications/registering-for-a-github-certifications-exam.md @@ -5,6 +5,8 @@ allowTitleToDifferFromFilename: true versions: feature: github-certification shortTitle: Registering for an exam +category: + - Explore GitHub plans and features --- {% ifversion ghec %} diff --git a/content/get-started/start-your-journey/about-github-and-git.md b/content/get-started/start-your-journey/about-github-and-git.md index a8fad7493e79..09362695c002 100644 --- a/content/get-started/start-your-journey/about-github-and-git.md +++ b/content/get-started/start-your-journey/about-github-and-git.md @@ -9,6 +9,8 @@ versions: type: overview redirect_from: - /get-started/quickstart/about-github-and-git +category: + - Set up your account on GitHub --- ## About {% data variables.product.github %} diff --git a/content/get-started/start-your-journey/creating-an-account-on-github.md b/content/get-started/start-your-journey/creating-an-account-on-github.md index 814bdbfca43a..5723fcd8ea77 100644 --- a/content/get-started/start-your-journey/creating-an-account-on-github.md +++ b/content/get-started/start-your-journey/creating-an-account-on-github.md @@ -14,6 +14,8 @@ redirect_from: versions: fpt: '*' ghec: '*' +category: + - Set up your account on GitHub --- ## About your personal account on {% data variables.product.prodname_dotcom %} diff --git a/content/get-started/start-your-journey/downloading-files-from-github.md b/content/get-started/start-your-journey/downloading-files-from-github.md index c49b4e6cbcf1..a9bf3af9d0fe 100644 --- a/content/get-started/start-your-journey/downloading-files-from-github.md +++ b/content/get-started/start-your-journey/downloading-files-from-github.md @@ -9,6 +9,8 @@ versions: type: tutorial redirect_from: - /get-started/quickstart/downloading-files-from-github +category: + - Explore and contribute --- ## Introduction diff --git a/content/get-started/start-your-journey/finding-inspiration-on-github.md b/content/get-started/start-your-journey/finding-inspiration-on-github.md index 5ef723ca4053..52f833bf6db0 100644 --- a/content/get-started/start-your-journey/finding-inspiration-on-github.md +++ b/content/get-started/start-your-journey/finding-inspiration-on-github.md @@ -14,6 +14,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Explore and contribute --- ## Introduction diff --git a/content/get-started/start-your-journey/git-and-github-learning-resources.md b/content/get-started/start-your-journey/git-and-github-learning-resources.md index 2bbffc041347..678034c98605 100644 --- a/content/get-started/start-your-journey/git-and-github-learning-resources.md +++ b/content/get-started/start-your-journey/git-and-github-learning-resources.md @@ -15,6 +15,8 @@ versions: authors: - GitHub shortTitle: Learning resources +category: + - Set up your account on GitHub --- ## Using {% data variables.product.github %} diff --git a/content/get-started/start-your-journey/hello-world.md b/content/get-started/start-your-journey/hello-world.md index f3dccf3f0453..34b4d750e599 100644 --- a/content/get-started/start-your-journey/hello-world.md +++ b/content/get-started/start-your-journey/hello-world.md @@ -8,6 +8,8 @@ versions: type: quick_start redirect_from: - /get-started/quickstart/hello-world +category: + - Explore and contribute --- ## Introduction diff --git a/content/get-started/start-your-journey/setting-up-your-profile.md b/content/get-started/start-your-journey/setting-up-your-profile.md index 546fcfa98882..b9130006a78c 100644 --- a/content/get-started/start-your-journey/setting-up-your-profile.md +++ b/content/get-started/start-your-journey/setting-up-your-profile.md @@ -9,6 +9,8 @@ versions: type: how_to redirect_from: - /get-started/quickstart/setting-up-your-profile +category: + - Set up your account on GitHub --- ## About your profile diff --git a/content/get-started/start-your-journey/uploading-a-project-to-github.md b/content/get-started/start-your-journey/uploading-a-project-to-github.md index e60a4937cad0..8ab89c72097a 100644 --- a/content/get-started/start-your-journey/uploading-a-project-to-github.md +++ b/content/get-started/start-your-journey/uploading-a-project-to-github.md @@ -9,6 +9,8 @@ versions: type: tutorial redirect_from: - /get-started/quickstart/uploading-a-project-to-github +category: + - Explore and contribute --- ## Introduction diff --git a/content/get-started/using-git/about-git-rebase.md b/content/get-started/using-git/about-git-rebase.md index 4686b8b46c96..14991a4bd39d 100644 --- a/content/get-started/using-git/about-git-rebase.md +++ b/content/get-started/using-git/about-git-rebase.md @@ -12,6 +12,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Work with Git --- Typically, you would use `git rebase` to: diff --git a/content/get-started/using-git/about-git-subtree-merges.md b/content/get-started/using-git/about-git-subtree-merges.md index 874051e140e6..a1b65ae25908 100644 --- a/content/get-started/using-git/about-git-subtree-merges.md +++ b/content/get-started/using-git/about-git-subtree-merges.md @@ -12,6 +12,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Work with Git --- ## About subtree merges diff --git a/content/get-started/using-git/about-git.md b/content/get-started/using-git/about-git.md index d8bf39985b54..669905a2a9a8 100644 --- a/content/get-started/using-git/about-git.md +++ b/content/get-started/using-git/about-git.md @@ -6,6 +6,8 @@ versions: ghes: '*' ghec: '*' type: overview +category: + - Set up Git --- ## About version control and Git diff --git a/content/get-started/using-git/dealing-with-non-fast-forward-errors.md b/content/get-started/using-git/dealing-with-non-fast-forward-errors.md index 0e6dbff04ac7..8fec6d6494c3 100644 --- a/content/get-started/using-git/dealing-with-non-fast-forward-errors.md +++ b/content/get-started/using-git/dealing-with-non-fast-forward-errors.md @@ -11,6 +11,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Non-fast-forward error +category: + - Work with Git --- If another person has pushed to the same branch as you, Git won't be able to push your changes: diff --git a/content/get-started/using-git/dealing-with-special-characters-in-branch-and-tag-names.md b/content/get-started/using-git/dealing-with-special-characters-in-branch-and-tag-names.md index f65e84d8f366..58c2bb072f93 100644 --- a/content/get-started/using-git/dealing-with-special-characters-in-branch-and-tag-names.md +++ b/content/get-started/using-git/dealing-with-special-characters-in-branch-and-tag-names.md @@ -6,6 +6,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Special characters in names +category: + - Work with Git --- ## About branch and tag names diff --git a/content/get-started/using-git/getting-changes-from-a-remote-repository.md b/content/get-started/using-git/getting-changes-from-a-remote-repository.md index ce54de94c301..c956aad7cb96 100644 --- a/content/get-started/using-git/getting-changes-from-a-remote-repository.md +++ b/content/get-started/using-git/getting-changes-from-a-remote-repository.md @@ -12,6 +12,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Get changes from a remote +category: + - Work with Git --- ## Options for getting changes diff --git a/content/get-started/using-git/pushing-commits-to-a-remote-repository.md b/content/get-started/using-git/pushing-commits-to-a-remote-repository.md index 7fcb68f29449..d8fe70d232f9 100644 --- a/content/get-started/using-git/pushing-commits-to-a-remote-repository.md +++ b/content/get-started/using-git/pushing-commits-to-a-remote-repository.md @@ -12,6 +12,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Push commits to a remote +category: + - Work with Git --- ## About `git push` diff --git a/content/get-started/using-git/resolving-merge-conflicts-after-a-git-rebase.md b/content/get-started/using-git/resolving-merge-conflicts-after-a-git-rebase.md index 2aaa3a9bd3df..8db1546e8914 100644 --- a/content/get-started/using-git/resolving-merge-conflicts-after-a-git-rebase.md +++ b/content/get-started/using-git/resolving-merge-conflicts-after-a-git-rebase.md @@ -11,6 +11,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Resolve conflicts after rebase +category: + - Work with Git --- After you reorder and manipulate commits using `git rebase`, should a merge conflict occur, Git will tell you so with the following message printed to the terminal: diff --git a/content/get-started/using-git/splitting-a-subfolder-out-into-a-new-repository.md b/content/get-started/using-git/splitting-a-subfolder-out-into-a-new-repository.md index a6f8c7e6cbc6..c29a0a3be800 100644 --- a/content/get-started/using-git/splitting-a-subfolder-out-into-a-new-repository.md +++ b/content/get-started/using-git/splitting-a-subfolder-out-into-a-new-repository.md @@ -12,6 +12,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Splitting a subfolder +category: + - Work with Git --- > [!NOTE] diff --git a/content/get-started/using-git/troubleshooting-the-2-gb-push-limit.md b/content/get-started/using-git/troubleshooting-the-2-gb-push-limit.md index 56bc92b80066..8af69ee9520c 100644 --- a/content/get-started/using-git/troubleshooting-the-2-gb-push-limit.md +++ b/content/get-started/using-git/troubleshooting-the-2-gb-push-limit.md @@ -6,6 +6,8 @@ versions: fpt: '*' ghec: '*' shortTitle: Maximum push limit +category: + - Work with Git --- ## About the push limit diff --git a/content/get-started/using-git/using-git-rebase-on-the-command-line.md b/content/get-started/using-git/using-git-rebase-on-the-command-line.md index 414d716193f2..3a9cf64cc7b5 100644 --- a/content/get-started/using-git/using-git-rebase-on-the-command-line.md +++ b/content/get-started/using-git/using-git-rebase-on-the-command-line.md @@ -12,6 +12,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Git rebase +category: + - Work with Git --- ## Using Git rebase diff --git a/content/get-started/using-github-docs/about-versions-of-github-docs.md b/content/get-started/using-github-docs/about-versions-of-github-docs.md index f77ef279c4d5..93db249784ff 100644 --- a/content/get-started/using-github-docs/about-versions-of-github-docs.md +++ b/content/get-started/using-github-docs/about-versions-of-github-docs.md @@ -8,6 +8,8 @@ versions: shortTitle: Docs versions redirect_from: - /get-started/learning-about-github/about-versions-of-github-docs +category: + - Explore GitHub plans and features --- ## About versions of {% data variables.product.prodname_docs %} diff --git a/content/get-started/using-github-docs/using-hover-cards-on-github-docs.md b/content/get-started/using-github-docs/using-hover-cards-on-github-docs.md index 80dbf2fd182c..7cdb00a80873 100644 --- a/content/get-started/using-github-docs/using-hover-cards-on-github-docs.md +++ b/content/get-started/using-github-docs/using-hover-cards-on-github-docs.md @@ -8,6 +8,8 @@ versions: shortTitle: Hover cards redirect_from: - /get-started/learning-about-github/using-hover-cards-on-github-docs +category: + - Explore GitHub plans and features --- ## About hover cards diff --git a/content/get-started/using-github/allowing-access-to-githubs-services-from-a-restricted-network.md b/content/get-started/using-github/allowing-access-to-githubs-services-from-a-restricted-network.md index f10e2afcd710..c2d12360688f 100644 --- a/content/get-started/using-github/allowing-access-to-githubs-services-from-a-restricted-network.md +++ b/content/get-started/using-github/allowing-access-to-githubs-services-from-a-restricted-network.md @@ -5,6 +5,8 @@ versions: fpt: '*' ghec: '*' shortTitle: Allow network access +category: + - Set up your account on GitHub --- ## About access to {% data variables.product.github %} from a restricted network diff --git a/content/get-started/using-github/communicating-on-github.md b/content/get-started/using-github/communicating-on-github.md index 16faaecc0b5e..a6c486c2efe9 100644 --- a/content/get-started/using-github/communicating-on-github.md +++ b/content/get-started/using-github/communicating-on-github.md @@ -12,6 +12,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Explore and contribute --- ## Introduction diff --git a/content/get-started/using-github/connecting-to-github.md b/content/get-started/using-github/connecting-to-github.md index 6e85376c71e3..c61136b05245 100644 --- a/content/get-started/using-github/connecting-to-github.md +++ b/content/get-started/using-github/connecting-to-github.md @@ -5,6 +5,8 @@ versions: fpt: '*' ghec: '*' ghes: '*' +category: + - Set up your account on GitHub --- ## Introduction diff --git a/content/get-started/using-github/exploring-early-access-releases-with-feature-preview.md b/content/get-started/using-github/exploring-early-access-releases-with-feature-preview.md index 53bb20f93901..fe8c35157f07 100644 --- a/content/get-started/using-github/exploring-early-access-releases-with-feature-preview.md +++ b/content/get-started/using-github/exploring-early-access-releases-with-feature-preview.md @@ -9,6 +9,8 @@ versions: fpt: '*' ghec: '*' shortTitle: Feature preview +category: + - Customize your experience --- ## {% data variables.product.prodname_dotcom %}'s release cycle diff --git a/content/get-started/using-github/github-flow.md b/content/get-started/using-github/github-flow.md index c5455082e25b..fc0222e5b373 100644 --- a/content/get-started/using-github/github-flow.md +++ b/content/get-started/using-github/github-flow.md @@ -13,6 +13,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Explore and contribute --- ## Introduction diff --git a/content/get-started/using-github/github-mobile.md b/content/get-started/using-github/github-mobile.md index 99436b81ed9b..bc52e1306f9a 100644 --- a/content/get-started/using-github/github-mobile.md +++ b/content/get-started/using-github/github-mobile.md @@ -10,6 +10,8 @@ redirect_from: - /get-started/using-github/github-for-mobile - /github/getting-started-with-github/github-for-mobile - /github/getting-started-with-github/using-github/github-for-mobile +category: + - Customize your experience --- ## About {% data variables.product.prodname_mobile %} diff --git a/content/get-started/using-github/supported-browsers.md b/content/get-started/using-github/supported-browsers.md index e95f3c6e99bd..d1ee961adce1 100644 --- a/content/get-started/using-github/supported-browsers.md +++ b/content/get-started/using-github/supported-browsers.md @@ -11,6 +11,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Set up your account on GitHub --- ## About web browser support diff --git a/content/get-started/using-github/troubleshooting-connectivity-problems.md b/content/get-started/using-github/troubleshooting-connectivity-problems.md index 3ccab20ec4e9..797d3525b2fd 100644 --- a/content/get-started/using-github/troubleshooting-connectivity-problems.md +++ b/content/get-started/using-github/troubleshooting-connectivity-problems.md @@ -9,6 +9,8 @@ versions: fpt: '*' ghec: '*' shortTitle: Connectivity problems +category: + - Set up your account on GitHub --- Most often, connection problems occur because a firewall, proxy server, corporate network, or other network is configured in a way that blocks {% data variables.product.prodname_dotcom %}. diff --git a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md index e0db2628e907..48fe9adaeb2f 100644 --- a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md +++ b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md @@ -13,6 +13,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Share and reuse content --- ## About gists diff --git a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md index 71a6d1f7def9..d6251132b94d 100644 --- a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md +++ b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md @@ -10,6 +10,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Share and reuse content --- ## Forking gists diff --git a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/moderating-gist-comments.md b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/moderating-gist-comments.md index 7c265154fb97..2cc0e3d4c302 100644 --- a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/moderating-gist-comments.md +++ b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/moderating-gist-comments.md @@ -5,6 +5,8 @@ versions: fpt: '*' ghes: '>=3.17' ghec: '*' +category: + - Share and reuse content --- ## Disabling comments diff --git a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/saving-gists-with-stars.md b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/saving-gists-with-stars.md index 6ab75c113eed..002be5cf797b 100644 --- a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/saving-gists-with-stars.md +++ b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/saving-gists-with-stars.md @@ -5,6 +5,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Share and reuse content --- ## Starring a gist diff --git a/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md b/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md index 9fcf5fc523ea..4dfad59fbfe8 100644 --- a/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md +++ b/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md @@ -11,6 +11,8 @@ versions: ghes: '*' ghec: '*' shortTitle: About writing & formatting +category: + - Write and format content --- {% data reusables.getting-started.what-is-markdown %} diff --git a/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md b/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md index 910ddae27080..f695150c5b59 100644 --- a/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md +++ b/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md @@ -11,6 +11,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Basic formatting syntax +category: + - Write and format content --- ## Headings diff --git a/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github.md b/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github.md index b117e27f06fb..b92b8ca130bc 100644 --- a/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github.md +++ b/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github.md @@ -7,6 +7,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Quickstart +category: + - Write and format content --- ## Introduction diff --git a/content/get-started/writing-on-github/working-with-advanced-formatting/about-tasklists.md b/content/get-started/writing-on-github/working-with-advanced-formatting/about-tasklists.md index 52e4505535d2..9630e0145706 100644 --- a/content/get-started/writing-on-github/working-with-advanced-formatting/about-tasklists.md +++ b/content/get-started/writing-on-github/working-with-advanced-formatting/about-tasklists.md @@ -13,6 +13,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Write and format content --- ## About tasklists diff --git a/content/get-started/writing-on-github/working-with-advanced-formatting/attaching-files.md b/content/get-started/writing-on-github/working-with-advanced-formatting/attaching-files.md index 9d3b2f6559d3..4ab34e02f6e6 100644 --- a/content/get-started/writing-on-github/working-with-advanced-formatting/attaching-files.md +++ b/content/get-started/writing-on-github/working-with-advanced-formatting/attaching-files.md @@ -12,6 +12,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Write and format content --- {% ifversion ghes %} diff --git a/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md b/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md index 1d412cc11b61..6c8ba2869c8d 100644 --- a/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md +++ b/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md @@ -11,6 +11,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Auto linked references +category: + - Write and format content --- ## URLs diff --git a/content/get-started/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md b/content/get-started/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md index 58cc8abbc511..cb3e7e9e5f98 100644 --- a/content/get-started/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md +++ b/content/get-started/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md @@ -12,6 +12,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Permanent links to code +category: + - Write and format content --- ## Linking to code diff --git a/content/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md b/content/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md index 765f4f7b731c..ef633d60ebbd 100644 --- a/content/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md +++ b/content/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md @@ -11,6 +11,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Create code blocks +category: + - Write and format content --- ## Fenced code blocks diff --git a/content/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams.md b/content/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams.md index 8df3b7777830..d4140206c48f 100644 --- a/content/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams.md +++ b/content/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams.md @@ -7,6 +7,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Create diagrams +category: + - Write and format content --- ## About creating diagrams diff --git a/content/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md b/content/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md index 5cbf022ed92a..17158d239fcc 100644 --- a/content/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md +++ b/content/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md @@ -9,6 +9,8 @@ versions: redirect_from: - /github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections shortTitle: Collapsed sections +category: + - Write and format content --- ## Creating a collapsed section diff --git a/content/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md b/content/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md index 7512a7862b30..7b4b2d4a7747 100644 --- a/content/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md +++ b/content/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md @@ -11,6 +11,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Organized data with tables +category: + - Write and format content --- ## Creating a table diff --git a/content/get-started/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md b/content/get-started/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md index e02344ae28be..c2fcaa61fab0 100644 --- a/content/get-started/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md +++ b/content/get-started/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md @@ -8,6 +8,8 @@ versions: ghec: '*' redirect_from: - /github/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests +category: + - Write and format content --- ## Linking a pull request to an issue diff --git a/content/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions.md b/content/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions.md index 89473b6d99af..21158771861b 100644 --- a/content/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions.md +++ b/content/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions.md @@ -7,6 +7,8 @@ versions: ghes: '*' ghec: '*' shortTitle: Mathematical expressions +category: + - Write and format content --- ## About writing mathematical expressions diff --git a/content/get-started/writing-on-github/working-with-saved-replies/about-saved-replies.md b/content/get-started/writing-on-github/working-with-saved-replies/about-saved-replies.md index cff09a3abd2a..643908b49acc 100644 --- a/content/get-started/writing-on-github/working-with-saved-replies/about-saved-replies.md +++ b/content/get-started/writing-on-github/working-with-saved-replies/about-saved-replies.md @@ -9,6 +9,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Share and reuse content --- Saved replies allow you to create a reusable response to issues and pull requests. Save time by creating a saved reply for the responses you use most frequently. diff --git a/content/get-started/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md b/content/get-started/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md index 5e98e756b8a9..1de3b078937e 100644 --- a/content/get-started/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md +++ b/content/get-started/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md @@ -9,6 +9,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Share and reuse content --- {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.saved_replies %} diff --git a/content/get-started/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md b/content/get-started/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md index 12e812e28905..edf8f7374cd8 100644 --- a/content/get-started/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md +++ b/content/get-started/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md @@ -9,6 +9,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Share and reuse content --- {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.saved_replies %} diff --git a/content/get-started/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md b/content/get-started/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md index 97e08693f907..c79eacb5078d 100644 --- a/content/get-started/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md +++ b/content/get-started/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md @@ -10,6 +10,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Share and reuse content --- {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.saved_replies %} diff --git a/content/get-started/writing-on-github/working-with-saved-replies/using-saved-replies.md b/content/get-started/writing-on-github/working-with-saved-replies/using-saved-replies.md index 0eedd369c62b..914c21838c62 100644 --- a/content/get-started/writing-on-github/working-with-saved-replies/using-saved-replies.md +++ b/content/get-started/writing-on-github/working-with-saved-replies/using-saved-replies.md @@ -9,6 +9,8 @@ versions: fpt: '*' ghes: '*' ghec: '*' +category: + - Share and reuse content --- {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} diff --git a/data/reusables/actions/actions-usage-metrics-not-billing-metrics.md b/data/reusables/actions/actions-usage-metrics-not-billing-metrics.md index 9402fad4c976..2bf7472550f2 100644 --- a/data/reusables/actions/actions-usage-metrics-not-billing-metrics.md +++ b/data/reusables/actions/actions-usage-metrics-not-billing-metrics.md @@ -1,3 +1,3 @@ {% data variables.product.prodname_actions %} usage metrics do not apply minute multipliers to the metrics displayed. While they _can_ help you understand your bill, their primary purpose is to help you understand how and where Actions minutes are being used in your organization. -For more information about minute multipliers, see [AUTOTITLE](/billing/managing-billing-for-github-actions/about-billing-for-github-actions#minute-multipliers). +For more information about minute multipliers, see [AUTOTITLE](/billing/concepts/product-billing/github-actions#baseline-minute-costs). \ No newline at end of file diff --git a/data/reusables/copilot/coding-agent/new-agent-task-form-instructions.md b/data/reusables/copilot/coding-agent/new-agent-task-form-instructions.md index 67bf8ca896b0..d37ba95d0298 100644 --- a/data/reusables/copilot/coding-agent/new-agent-task-form-instructions.md +++ b/data/reusables/copilot/coding-agent/new-agent-task-form-instructions.md @@ -1,5 +1,5 @@ 1. Using the dropdown menu in the prompt field, select the repository you want {% data variables.product.prodname_copilot_short %} to work in. -1. Type a prompt describing your request. +1. Type a prompt describing your request. You can also add visual inputs like screenshots or UI mockups by pasting, dragging, or uploading an image. Files supported: image/png, image/jpeg, image/gif, image/webp. For example, `Implement a user friendly message for common errors.` diff --git a/src/content-pipelines/scripts/update.ts b/src/content-pipelines/scripts/update.ts index ca4e932af628..573f5853c2cc 100644 --- a/src/content-pipelines/scripts/update.ts +++ b/src/content-pipelines/scripts/update.ts @@ -324,6 +324,24 @@ async function main(): Promise { fs.writeFileSync(SHA_FILE, `${currentSha}\n`) console.log(`\nUpdated ${SHA_FILE} to ${currentSha}`) } + + // ---- Write source change metadata to $GITHUB_OUTPUT ---- + // The workflow uses these values to populate the PR body with reviewer breadcrumbs. + const ghOutput = process.env.GITHUB_OUTPUT + if (ghOutput) { + const compareUrl = storedSha + ? `https://github.com/${SOURCE_REPO}/compare/${storedSha}...${currentSha}` + : `https://github.com/${SOURCE_REPO}/commit/${currentSha}` + const shortRange = storedSha + ? `${storedSha.slice(0, 7)}...${currentSha.slice(0, 7)}` + : currentSha.slice(0, 7) + + const outputLines = [`compare_url=${compareUrl}`, `short_range=${shortRange}`] + + fs.appendFileSync(ghOutput, `${outputLines.join('\n')}\n`) + console.log('Wrote source change metadata to $GITHUB_OUTPUT') + } + console.log('Done.') }