chore: sync upstream

.cspell.json

@@ -0,0 +1,3 @@
+{
+  "words": ["ISCLOAM", "georeferenced", "MGRS"]
+}

.devcontainer/Dockerfile

@@ -0,0 +1,28 @@
+FROM ubuntu:22.04
+
+SHELL ["/bin/bash", "-o", "pipefail", "-c"]
+
+ARG USER=autoware
+ENV HOME=/home/$USER
+ENV PATH=$PATH:/home/$USER/.local/bin
+
+# hadolint ignore=DL3008
+RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
+    && apt-get -y install --no-install-recommends \
+      sudo \
+      git \
+      python3 \
+      python3-pip \
+      python-is-python3 \
+    && apt-get autoremove -y && apt-get clean -y && rm -rf /var/lib/apt/lists/*
+
+RUN groupadd work -g 1000 \
+  && useradd -ms /bin/bash "$USER" -g 1000 -u 1000 \
+  && printf "%s:%s" "$USER" "$USER" | chpasswd \
+  && printf "%s ALL= NOPASSWD: ALL\n" "$USER" >> /etc/sudoers
+
+USER $USER
+WORKDIR $HOME
+
+# hadolint ignore=DL3013
+RUN python -m pip install --user --no-cache-dir pre-commit

.devcontainer/devcontainer.json

@@ -0,0 +1,26 @@
+{
+  "name": "Autoware Docs",
+  "build": {
+    "dockerfile": "Dockerfile",
+    "options": ["--load"],
+    "context": ".."
+  },
+  "customizations": {
+    "vscode": {
+      "settings": {
+        "terminal.integrated.shell.linux": "/bin/bash"
+      },
+      "extensions": [
+        "redhat.vscode-yaml",
+        "esbenp.prettier-vscode",
+        "DavidAnson.vscode-markdownlint"
+      ]
+    }
+  },
+  "forwardPorts": [8000],
+  "postCreateCommand": "pip install --user -r mkdocs-requirements.txt",
+  "remoteUser": "autoware",
+
+  "workspaceFolder": "/autoware-documentation",
+  "workspaceMount": "source=${localWorkspaceFolder},target=/autoware-documentation,type=bind"
+}

.github/ISSUE_TEMPLATE/config.yml

@@ -1,3 +1,7 @@
+# This file is automatically synced from:
+# https://github.com/autowarefoundation/sync-file-templates
+# To make changes, update the source repository and follow the guidelines in its README.
+
 blank_issues_enabled: false
 contact_links:
   - name: Question

.github/ISSUE_TEMPLATE/simple-issue.yaml

@@ -0,0 +1,19 @@
+name: Simple Issue
+description: Create a simple issue
+body:
+  - type: checkboxes
+    attributes:
+      label: Checklist
+      description: Confirm the following items before proceeding. If one cannot be satisfied, create a discussion thread instead.
+      options:
+        - label: I've read the [contribution guidelines](https://github.com/autowarefoundation/autoware/blob/main/CONTRIBUTING.md).
+          required: true
+        - label: I've searched other issues and no duplicate issues were found.
+          required: true
+
+  - type: textarea
+    attributes:
+      label: Description
+      description: Write a brief description of the issue.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/task.yaml

@@ -1,3 +1,7 @@
+# This file is automatically synced from:
+# https://github.com/autowarefoundation/sync-file-templates
+# To make changes, update the source repository and follow the guidelines in its README.
+
 name: Task
 description: Plan a task
 body:

.github/dependabot.yaml

@@ -1,10 +1,15 @@
+# This file is automatically synced from:
+# https://github.com/autowarefoundation/sync-file-templates
+# To make changes, update the source repository and follow the guidelines in its README.
+
 version: 2
 updates:
   - package-ecosystem: github-actions
     directory: /
+    # https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file#scheduleinterval
     schedule:
-      interval: daily
+      interval: monthly
     open-pull-requests-limit: 1
     labels:
-      - bot
-      - github-actions
+      - tag:bot
+      - type:github-actions

.github/pull_request_template.md

@@ -0,0 +1,5 @@
+## Description
+
+## How was this PR tested?
+
+Tested by the deploy-docs workflow.

.github/stale.yml

@@ -1,10 +1,14 @@
+# This file is automatically synced from:
+# https://github.com/autowarefoundation/sync-file-templates
+# To make changes, update the source repository and follow the guidelines in its README.
+
 # Modified from https://github.com/probot/stale#usage
 
 # Number of days of inactivity before an Issue or Pull Request with the stale label is closed
 daysUntilClose: false
 
 # Label to use when marking as stale
-staleLabel: stale
+staleLabel: status:stale
 
 # Comment to post when marking as stale
 markComment: >

.github/sync-files.yaml

@@ -1,4 +1,5 @@
-- repository: autowarefoundation/autoware
+- repository: autowarefoundation/sync-file-templates
+  source-dir: sources
   files:
     - source: CODE_OF_CONDUCT.md
     - source: CONTRIBUTING.md
@@ -7,10 +8,9 @@
     - source: .github/ISSUE_TEMPLATE/config.yml
     - source: .github/ISSUE_TEMPLATE/task.yaml
     - source: .github/dependabot.yaml
+    - source: .github/pull_request_template.md
     - source: .github/stale.yml
-    - source: .github/workflows/github-release.yaml
-    - source: .github/workflows/pre-commit.yaml
-    - source: .github/workflows/pre-commit-optional.yaml
+    - source: .github/workflows/comment-on-pr.yaml
     - source: .github/workflows/semantic-pull-request.yaml
     - source: .github/workflows/spell-check-differential.yaml
     - source: .github/workflows/sync-files.yaml
@@ -24,10 +24,18 @@
               "pattern": "^http://localhost"' \
           {source}
     - source: .markdownlint.yaml
+      pre-commands: |
+        sd 'MD059: false' 'MD059: false\nMD060: false' {source}
+    - source: .pre-commit-config.yaml
+      pre-commands: |
+        sd -f s \
+        '  - repo: https://github.com/autowarefoundation/autoware-guideline-check\n(.|\n)*?\n  - repo: ' \
+        '  - repo: ' {source}
     - source: .pre-commit-config-optional.yaml
     - source: .prettierignore
     - source: .prettierrc.yaml
     - source: .yamllint.yaml
+    - source: setup.cfg
 
 - repository: autowarefoundation/autoware-documentation
   files:

.github/workflows/comment-on-pr.yaml

@@ -0,0 +1,29 @@
+# This file is automatically synced from:
+# https://github.com/autowarefoundation/sync-file-templates
+# To make changes, update the source repository and follow the guidelines in its README.
+
+name: comment-on-pr
+on:
+  pull_request_target:
+
+jobs:
+  comment-on-pr:
+    runs-on: ubuntu-22.04
+    permissions:
+      pull-requests: write
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Initial PR comment
+        uses: marocchino/sticky-pull-request-comment@v2
+        with:
+          message: |
+            Thank you for contributing to the Autoware project!
+
+            🚧 If your pull request is in progress, [switch it to draft mode](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#converting-a-pull-request-to-a-draft).
+
+            Please ensure:
+            - You've checked our [contribution guidelines](https://autowarefoundation.github.io/autoware-documentation/main/contributing/).
+            - Your PR follows our [pull request guidelines](https://autowarefoundation.github.io/autoware-documentation/main/contributing/pull-request-guidelines/).
+            - All required CI checks pass before [marking the PR ready for review](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#marking-a-pull-request-as-ready-for-review).

.github/workflows/delete-closed-pr-docs.yaml

@@ -18,3 +18,10 @@ jobs:
         uses: autowarefoundation/autoware-github-actions/delete-closed-pr-docs@v1
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
+
+  reorder-versions-json:
+    needs:
+      - delete-closed-pr-docs
+    uses: ./.github/workflows/reorder-versions.yaml
+    secrets:
+      token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/delete-removed-branch-docs.yaml

@@ -0,0 +1,101 @@
+name: delete-removed-branch-docs
+
+on:
+  delete:
+  workflow_dispatch:
+
+jobs:
+  delete-removed-branch-docs:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: 3.12
+
+      - name: Install MkDocs requirements
+        run: pip3 install -r mkdocs-requirements.txt
+
+      - name: Get mike versions starting with branch-
+        id: mike_branch_versions
+        run: |
+          VERSIONS=$(mike list | grep '^branch-' || true)
+
+          echo "Found versions:"
+          echo "$VERSIONS"
+
+          echo "count=$(echo "$VERSIONS" | grep -c .)" >> $GITHUB_OUTPUT
+          echo "versions<<EOF" >> $GITHUB_OUTPUT
+          echo "$VERSIONS" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: No branch-* mike versions => exit successfully
+        if: ${{ steps.mike_branch_versions.outputs.count == '0' }}
+        run: echo "No branch-* versions found. Exiting."
+
+      - name: Normalize mike branch names
+        id: norm_mike
+        run: |
+          MIKE=$(echo "${{ steps.mike_branch_versions.outputs.versions }}" \
+            | sed -e 's/^branch-//' -e 's|/|-|g')
+
+          echo "Normalized mike branch names:"
+          echo "$MIKE"
+
+          echo "list<<EOF" >> $GITHUB_OUTPUT
+          echo "$MIKE" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Get remote Git branches (normalized)
+        id: norm_git
+        run: |
+          git fetch --all --prune --quiet
+
+          GIT=$(git branch -r --format='%(refname:short)' | sed 's|origin/||' | sort -u)
+          GIT=$(echo "$GIT" | sed 's|/|-|g')
+
+          echo "Normalized remote git branches:"
+          echo "$GIT"
+
+          echo "list<<EOF" >> $GITHUB_OUTPUT
+          echo "$GIT" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Set git config
+        uses: autowarefoundation/autoware-github-actions/set-git-config@v1
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Delete orphaned mike branch versions
+        run: |
+          echo "==> Mike branches:"
+          echo "${{ steps.norm_mike.outputs.list }}"
+
+          echo "==> Git branches:"
+          echo "${{ steps.norm_git.outputs.list }}"
+
+          echo "==> Checking for orphans…"
+
+          echo "${{ steps.norm_mike.outputs.list }}" | while read MB; do
+            [ -z "$MB" ] && continue
+
+            if echo "${{ steps.norm_git.outputs.list }}" | grep -qx "$MB"; then
+              echo "✔ branch-$MB exists — keeping"
+            else
+              echo "🔥 branch-$MB is orphaned — deleting"
+              mike delete --push "branch-$MB"
+            fi
+          done
+
+  reorder-versions-json:
+    needs:
+      - delete-removed-branch-docs
+    uses: ./.github/workflows/reorder-versions.yaml
+    secrets:
+      token: ${{ secrets.GITHUB_TOKEN }}