refactor: unify markdown release tracking blocks

.github/workflows/gitea-tracker.yml

@@ -37,7 +37,7 @@ jobs:
         if: steps.version.outputs.changed == 'true'
         uses: peter-evans/create-pull-request@v7
         with:
-          add-paths: '*.md'
+          add-paths: '**/*.md'
           branch: track/gitea-${{ steps.version.outputs.version }}
           commit-message: "docs: track Gitea ${{ steps.version.outputs.version }} pending verification"
           title: "Track Gitea ${{ steps.version.outputs.version }} compatibility"

.github/workflows/release.yml

@@ -16,6 +16,13 @@ jobs:
         with:
           go-version: '1.21'
 
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Test documentation tracker
+        run: python -B -m unittest discover -s .github/scripts -p 'test_*.py'
+
       - name: Test — mail template data contexts
         working-directory: tools
         run: go test ./...
@@ -33,14 +40,25 @@ jobs:
       contents: write
     steps:
       - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITEA_TOKEN || secrets.GITHUB_TOKEN }}
 
       - uses: actions/setup-go@v5
         with:
           go-version: '1.21'
 
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
       - name: Verify release notes
         run: test -s ".github/release-notes/${GITHUB_REF_NAME}.md"
 
+      - name: Update release labels in the archive
+        run: python -B .github/scripts/track_gitea_release.py --template-release "$TEMPLATE_RELEASE"
+        env:
+          TEMPLATE_RELEASE: ${{ github.ref_name }}
+
       - name: Generate static preview for the archive
         working-directory: tools
         run: go run . preview all
@@ -61,8 +79,44 @@ jobs:
       - name: Create Release
         uses: softprops/action-gh-release@v3
         with:
-          files: dist/*.zip,dist/*.tar.gz
+          files: |
+            dist/*.zip
+            dist/*.tar.gz
           fail_on_unmatched_files: true
           body_path: .github/release-notes/${{ github.ref_name }}.md
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITEA_TOKEN || secrets.GITHUB_TOKEN }}
+
+  sync-release-docs:
+    name: Update Latest Release Documentation
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: package
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: main
+          token: ${{ secrets.GITEA_TOKEN || secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Update marked release labels on main
+        run: python -B .github/scripts/track_gitea_release.py --template-release "$TEMPLATE_RELEASE"
+        env:
+          TEMPLATE_RELEASE: ${{ github.ref_name }}
+
+      - name: Commit documentation update
+        run: |
+          git add -- ':(glob)**/*.md'
+          if git diff --cached --quiet; then
+            echo "Release labels are already current."
+            exit 0
+          fi
+          git -c user.name='release-bot' -c user.email='release-bot@users.noreply.local' commit -m "docs: mark ${TEMPLATE_RELEASE} as latest release"
+          git push origin HEAD:main
+        env:
+          TEMPLATE_RELEASE: ${{ github.ref_name }}