diff --git a/.dockerignore b/.dockerignore index 087716df1f38..a8759150a47b 100644 --- a/.dockerignore +++ b/.dockerignore @@ -8,3 +8,4 @@ docs-early-access/ node_modules/ README.md tests/ + diff --git a/.editorconfig b/.editorconfig index beffa3084e7a..97d4ab004001 100644 --- a/.editorconfig +++ b/.editorconfig @@ -9,3 +9,4 @@ insert_final_newline = true [*.md] trim_trailing_whitespace = false + diff --git a/.env.example b/.env.example index 4a05a2416fb7..ad2d98a2d2e7 100644 --- a/.env.example +++ b/.env.example @@ -25,4 +25,3 @@ ENABLE_FASTLY_TESTING= # Needed to auth for AI search CSE_COPILOT_SECRET= CSE_COPILOT_ENDPOINT=https://cse-copilot-staging.service.iad.github.net - diff --git a/.gitattributes b/.gitattributes index c2d0a24ec960..43f4f98c56c4 100644 --- a/.gitattributes +++ b/.gitattributes @@ -4,3 +4,4 @@ # to native line endings on checkout. *.md text diff=markdown *.json.br filter=lfs diff=lfs merge=lfs -text + diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index 925504464505..9c848f2e6d0b 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -3,3 +3,4 @@ contact_links: - name: GitHub Support url: https://support.github.com/contact about: Contact Support if you're having trouble with your GitHub account. + diff --git a/.github/ISSUE_TEMPLATE/improve-existing-docs.yaml b/.github/ISSUE_TEMPLATE/improve-existing-docs.yaml index 0937f6d78c1c..e9d1b55ecb90 100644 --- a/.github/ISSUE_TEMPLATE/improve-existing-docs.yaml +++ b/.github/ISSUE_TEMPLATE/improve-existing-docs.yaml @@ -1,4 +1,4 @@ -name: Improve existing content +name: Improve existing content description: Make a suggestion to improve the content in an existing article. labels: - content diff --git a/.github/ISSUE_TEMPLATE/improve-the-site.yml b/.github/ISSUE_TEMPLATE/improve-the-site.yml index 5c6bc399c3c5..43500069dfda 100644 --- a/.github/ISSUE_TEMPLATE/improve-the-site.yml +++ b/.github/ISSUE_TEMPLATE/improve-the-site.yml @@ -1,6 +1,6 @@ name: Improve the docs.github.com site description: Make a suggestion or report a problem about the technical implementation of docs.github.com. -labels: +labels: - content body: - type: markdown diff --git a/.github/ISSUE_TEMPLATE/partner-contributed-documentation.yml b/.github/ISSUE_TEMPLATE/partner-contributed-documentation.yml index 0fe1def173ea..16d75892be3b 100644 --- a/.github/ISSUE_TEMPLATE/partner-contributed-documentation.yml +++ b/.github/ISSUE_TEMPLATE/partner-contributed-documentation.yml @@ -1,6 +1,6 @@ name: Partner-owned product documentation description: Initiate a set of tasks to be completed by a GitHub partner wishing to document how their product works with GitHub. -labels: +labels: - partner body: - type: markdown diff --git a/.github/actions/cache-nextjs/action.yml b/.github/actions/cache-nextjs/action.yml index c0251afbaff3..d1f4bdf26c3a 100644 --- a/.github/actions/cache-nextjs/action.yml +++ b/.github/actions/cache-nextjs/action.yml @@ -1,4 +1,4 @@ -# Based on https://nextjs.org/docs/pages/building-your-application/deploying/ci-build-caching#github-actions +#Based on https://nextjs.org/docs/pages/building-your-application/deploying/ci-build-caching#github-actions name: Cache Nextjs build cache diff --git a/.github/actions/clone-translations/action.yml b/.github/actions/clone-translations/action.yml index 1aa2e862f0ca..e7d6e634c4a0 100644 --- a/.github/actions/clone-translations/action.yml +++ b/.github/actions/clone-translations/action.yml @@ -5,7 +5,7 @@ description: Clone all remote translations so they're available inputs: token: description: PAT - required: true + required: true o runs: using: 'composite' diff --git a/.github/actions/get-changed-files/action.yml b/.github/actions/get-changed-files/action.yml index ba55f80a3ec4..02dea2c2f1b7 100644 --- a/.github/actions/get-changed-files/action.yml +++ b/.github/actions/get-changed-files/action.yml @@ -1,4 +1,4 @@ -name: Get changed files +name: Get changed files description: Get a list of changed files inputs: diff --git a/.github/workflows/Bearcodeql.yml b/.github/workflows/Bearcodeql.yml new file mode 100644 index 000000000000..503a0d5c75b7 --- /dev/null +++ b/.github/workflows/Bearcodeql.yml @@ -0,0 +1,101 @@ +# For most projects, this workflow file will not need changing; you simply need +# to commit it to your repository. +# +# You may wish to alter this file to override the set of languages analyzed, +# or to provide custom queries or build logic. +# +# ******** NOTE ******** +# We have attempted to detect the languages in your repository. Please check +# the `language` matrix defined below to confirm you have the correct set of +# supported CodeQL languages. +# +name: "CodeQL Advanced" + +on: + push: + branches: [ "main" ] + pull_request: + branches: [ "main" ] + schedule: + - cron: '22 22 * * 2' + +jobs: + analyze: + name: Analyze (${{ matrix.language }}) + # Runner size impacts CodeQL analysis time. To learn more, please see: + # - https://gh.io/recommended-hardware-resources-for-running-codeql + # - https://gh.io/supported-runners-and-hardware-resources + # - https://gh.io/using-larger-runners (GitHub.com only) + # Consider using larger runners or machines with greater resources for possible analysis time improvements. + runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }} + permissions: + # required for all workflows + security-events: write + + # required to fetch internal or private CodeQL packs + packages: read + + # only required for workflows in private repositories + actions: read + contents: read + + strategy: + fail-fast: false + matrix: + include: + - language: actions + build-mode: none + - language: javascript-typescript + build-mode: none + # CodeQL supports the following values keywords for 'language': 'actions', 'c-cpp', 'csharp', 'go', 'java-kotlin', 'javascript-typescript', 'python', 'ruby', 'rust', 'swift' + # Use `c-cpp` to analyze code written in C, C++ or both + # Use 'java-kotlin' to analyze code written in Java, Kotlin or both + # Use 'javascript-typescript' to analyze code written in JavaScript, TypeScript or both + # To learn more about changing the languages that are analyzed or customizing the build mode for your analysis, + # see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning. + # If you are analyzing a compiled language, you can modify the 'build-mode' for that language to customize how + # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages + steps: + - name: Checkout repository + uses: actions/checkout@v4 + + # Add any setup steps before running the `github/codeql-action/init` action. + # This includes steps like installing compilers or runtimes (`actions/setup-node` + # or others). This is typically only required for manual builds. + # - name: Setup runtime (example) + # uses: actions/setup-example@v1 + + # Initializes the CodeQL tools for scanning. + - name: Initialize CodeQL + uses: github/codeql-action/init@v4 + with: + languages: ${{ matrix.language }} + build-mode: ${{ matrix.build-mode }} + # If you wish to specify custom queries, you can do so here or in a config file. + # By default, queries listed here will override any specified in a config file. + # Prefix the list here with "+" to use these queries and those in the config file. + + # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs + # queries: security-extended,security-and-quality + + # If the analyze step fails for one of the languages you are analyzing with + # "We were unable to automatically build your code", modify the matrix above + # to set the build mode to "manual" for that language. Then modify this step + # to build your code. + # ℹ️ Command-line programs to run using the OS shell. + # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun + - name: Run manual build steps + if: matrix.build-mode == 'manual' + shell: bash + run: | + echo 'If you are using a "manual" build mode for one or more of the' \ + 'languages you are analyzing, replace this with the commands to build' \ + 'your code, for example:' + echo ' make bootstrap' + echo ' make release' + exit 1 + + - name: Perform CodeQL Analysis + uses: github/codeql-action/analyze@v4 + with: + category: "/language:${{matrix.language}}" diff --git a/.github/workflows/blank.yml b/.github/workflows/blank.yml new file mode 100644 index 000000000000..01502b13e19c --- /dev/null +++ b/.github/workflows/blank.yml @@ -0,0 +1,36 @@ +# This is a basic workflow to help you get started with Actions + +name: CI + +# Controls when the workflow will run +on: + # Triggers the workflow on push or pull request events but only for the "main" branch + push: + branches: [ "main" ] + pull_request: + branches: [ "main" ] + + # Allows you to run this workflow manually from the Actions tab + workflow_dispatch: + +# A workflow run is made up of one or more jobs that can run sequentially or in parallel +jobs: + # This workflow contains a single job called "build" + build: + # The type of runner that the job will run on + runs-on: ubuntu-latest + + # Steps represent a sequence of tasks that will be executed as part of the job + steps: + # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it + - uses: actions/checkout@v4 + + # Runs a single command using the runners shell + - name: Run a one-line script + run: echo Hello, world! + + # Runs a set of commands using the runners shell + - name: Run a multi-line script + run: | + echo Add other actions to build, + echo test, and deploy your project. diff --git a/.gitignore b/.gitignore index 20a95464ff62..3150b4060cc6 100644 --- a/.gitignore +++ b/.gitignore @@ -1,109 +1,29 @@ -# Test coverage reports -.coverage/ - -# macOS system files -.DS_Store - -# Environment variables (contains secrets) -.env - -# ESLint cache for faster linting -.eslintcache - -# JetBrains IDE files -.idea/ - -# Tracks package-lock.json installation state -.installed.package-lock.json - -# Linkinator full site link check results -.linkinator/ - -# Next.js build output -.next/ - -# Node.js version specification -.node-version - -# Precomputed page info cache (brotli compressed) -.pageinfo-cache.json.br - -# getRemoteJSON() disk cache for archived content -.remotejson-cache/ - -# VS Code workspace settings -.vscode/settings.json - -# TypeScript incremental build info -*.tsbuildinfo - -# Accidentally committed file that should be ignored -assets/images/help/writing/unordered-list-rendered (1).png - -# Old broken link checker output -blc_output.log - -# Old internal broken link checker output -blc_output_internal.log - -# Old broken links report -broken_links.md - -# Directories from the docs-early-access repo. Used for symlinks in local docs-internal checkouts. Don't add trailing slashes. -content/early-access -data/early-access -assets/images/early-access - -# Test coverage reports -coverage/ - -# Cloned for Elasticsearch indexing data -docs-internal-data/ - -# External link checker cache database -external-link-checker-db.json - -# Historical redirects cache (legacy) -lib/redirects/.redirects-cache*.json - -# Script execution logs -logs/ - -# GitHub Models API descriptions -models-gateway/ - -# Next.js TypeScript environment definitions -next-env.d.ts - -# Node.js dependencies -node_modules/ - -# Background process output -nohup.out - -# NPM debug logs -npm-debug.log - -# Playwright test reports -playwright-report/ - -# Playwright browser cache -playwright/.cache/ - -# REST API OpenAPI descriptions -rest-api-description/ - -# CodeQL CLI documentation source -semmle-code/ - -# Development table of contents static HTML files -src/dev-toc/static/ - -# Playwright test result artifacts -test-results/ - -# Temporary data files -tmp/ - -# Localized content from translation repositories -translations/ +# See https://www.dartlang.org/guides/libraries/private-files + +# Files and directories created by pub +.dart_tool/ +.packages +build/ +# If you're building an application, you may want to check-in your pubspec.lock +pubspec.lock + +# Directory created by dartdoc +# If you don't generate documentation locally you can remove this line. +doc/api/ + +# dotenv environment variables file +.env* + +# Avoid committing generated Javascript files: +*.dart.js +# Produced by the --dump-info flag. +*.info.json +# When generated by dart2js. Don't specify *.js if your +# project includes source files written in JavaScript. +*.js +*.js_ +*.js.deps +*.js.map + +.flutter-plugins +.flutter-plugins-dependencies diff --git a/CHANGELOG.md b/CHANGELOG.md index eb4bf8f8b096..85553b526157 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,4 +1,4 @@ -# Docs changelog +# Docs changelog **17 October 2025** @@ -8,7 +8,7 @@ To support accomplishing tasks without context switching or sifting through unre