ci: apt archive caching + template/docs refresh

[taliesin-ai]

Two related pieces of housekeeping (scope widened per Lea):

1. Apt archive caching (original scope): keep apt-get install always running — apt validates, so a stale/corrupt cache can only be slow, never broken (the #5746 failure class structurally cannot recur). Cache only the downloaded .deb archives via first-party actions/cache in a user-space Dir::Cache::Archives, with always-save keys (run_id + prefix restore) so archives track runner-image updates. Cold baseline measured at 23-44s per Linux job for the GTK4 set; this push's CI run restores the caches saved by the previous run, so its install steps demonstrate the warm path.

2. Template/docs refresh: bug_report.yml no longer tells v3 users their bug reports aren't accepted (stale policy banner removed; asks for latest alpha + wails3 doctor); PR template gets a current version example and documents the v3/UNRELEASED_CHANGELOG.md wording override; issue-labeler stops mapping 'master branch' to v2-only (v3 lives on master too); the nightly workflow display name drops the retired 'v3-alpha' branch reference; contributing.mdx branch instructions said main where the default branch is master, and now mention the changelog automation. Note: the suspected duplicate PULL_REQUEST_TEMPLATE.md was a case-insensitive-filesystem illusion; git tracks exactly one file.

Summary by CodeRabbit

• Documentation

  • Updated contributing and pull request guidance for current branching and changelog wording control.
  • Refined bug report instructions for the latest release line, including clearer doctor output requirements.

• Chores

  • Renamed the nightly release workflow display title.
  • Adjusted issue labeling rules and issue/template wording.

• Performance

  • Improved Linux CI dependency setup by caching APT package archives, making test runs faster and more consistent across Linux build and cross-compile workflows.

[coderabbitai]

Important

Review skipped

We couldn't safely recover the incremental review. No full review was started, and the last reviewed checkpoint was preserved. Retry later, or explicitly request a full review by commenting @coderabbitai full review.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

Walkthrough

This PR adds APT archive caching to several Linux GitHub Actions workflows and updates contributor-facing issue, PR, release, and documentation text for v2/v3 guidance.

Changes

APT Archive Caching

Layer / File(s)	Summary
build-and-test-v3.yml apt caching .github/workflows/build-and-test-v3.yml	Adds apt archive caching to test_go and test_templates jobs for GTK4/GTK3 dependency installs on ubuntu-latest.
build-and-test.yml apt caching .github/workflows/build-and-test.yml	Adds apt archive caching to test_go and test_templates jobs for Ubuntu 22.04/24.04 dependency installs.
cross-compile-test-v3.yml apt caching .github/workflows/cross-compile-test-v3.yml	Adds apt archive caching to the cross_compile job's Linux dependency install step.
pr-master.yml apt caching .github/workflows/pr-master.yml	Adds apt archive caching to the test_go job's Linux dependency install for Ubuntu 22.04 and 24.04 matrix entries.

Contributor Guidance Updates

Layer / File(s)	Summary
Issue and PR guidance .github/ISSUE_TEMPLATE/bug_report.yml, .github/pull_request_template.md	Updates bug report and PR template text for v3 reporting, doctor output, and changelog wording guidance.
Labels, release name, and docs .github/issue-labeler.yml, .github/workflows/nightly-release-v3.yml, docs/src/content/docs/contributing.mdx	Removes one label keyword, renames the nightly release workflow, and updates contributing docs for branch commands and v3 changelog notes.

Estimated code review effort: 2 (Simple) | ~12 minutes

Possibly related PRs

• wailsapp/wails#5149: Both modify Linux dependency install steps in GitHub Actions workflows to add APT caching behavior.
• wailsapp/wails#5150: Both update pr-master.yml to cache APT packages for Ubuntu Linux installs.
• wailsapp/wails#5624: Both update contributor guidance about v3 changelog wording and v3/UNRELEASED_CHANGELOG.md.

Suggested labels: Documentation

Suggested reviewers: leaanthony

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description summarizes the changes, but it omits the required issue link, testing details, type selection, and checklist items.	Add the issue reference, fill in the type and test sections, and complete the checklist items required by the template.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main CI caching and docs/template refresh changes.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch ci/apt-archive-cache

---

_{A rabbit hopped through CI with care,
Cached apt crumbs now linger there.
Docs got tidier, labels trimmed light,
Release names changed for a cleaner sight,
Hop-hop—YAML hums through the night. 🐇}

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.github/workflows/build-and-test-v3.yml:
- Around line 111-133: The apt archive cache is currently shared between jobs,
causing `test_go` and `test_templates` to overwrite each other’s cached
packages. Update the `actions/cache` configuration in the Ubuntu dependency
setup so the cache key and restore prefix include a job-specific identifier,
keeping the cache entries separate per job while preserving reuse within the
same job.

In @.github/workflows/cross-compile-test-v3.yml:
- Around line 94-107: The apt cache key and restore prefix in the cross-compile
workflow are too broad and can reuse packages across different runner
architectures. Update the cache configuration in the cache step for the
cross-compile dependencies to include matrix.runner in both the actions/cache
key and restore-keys so each architecture gets its own cache and cannot restore
from the wrong leg.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: d2530230-5299-4024-993d-1eb89c8bc124

📥 Commits

Reviewing files that changed from the base of the PR and between cd3779d and 836718e.

📒 Files selected for processing (4)

• .github/workflows/build-and-test-v3.yml
• .github/workflows/build-and-test.yml
• .github/workflows/cross-compile-test-v3.yml
• .github/workflows/pr-master.yml

[coderabbitai]

🧹 Nitpick comments (1)

.github/ISSUE_TEMPLATE/bug_report.yml (1)

10-10: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Hardcoded alpha version will go stale.

The alpha versioning scheme increments regularly (currently at v3.0.0-alpha2.110/111), so pinning a specific example like v3.0.0-alpha2.113 will quickly become outdated and could mislead reporters into thinking that's the current latest. Consider wording it more generically, e.g. "the latest tagged alpha release" without a specific version number, or link to the releases page.

✏️ Suggested wording tweak

-        ***For Wails v3 bugs: please use the latest tagged alpha (e.g. `v3.0.0-alpha2.113`), not a source install, and include the output of `wails3 doctor`.***
+        ***For Wails v3 bugs: please use the latest tagged alpha release (see the [releases page](https://github.com/wailsapp/wails/releases)), not a source install, and include the output of `wails3 doctor`.***

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.github/ISSUE_TEMPLATE/bug_report.yml at line 10, The bug report template
hardcodes a specific Wails v3 alpha version example that will quickly go stale.
Update the wording in the issue template to refer generically to the latest
tagged alpha release, and keep the guidance around using a tagged release plus
running wails3 doctor; use the existing bug_report.yml template text as the
place to adjust.

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In @.github/ISSUE_TEMPLATE/bug_report.yml:
- Line 10: The bug report template hardcodes a specific Wails v3 alpha version
example that will quickly go stale. Update the wording in the issue template to
refer generically to the latest tagged alpha release, and keep the guidance
around using a tagged release plus running wails3 doctor; use the existing
bug_report.yml template text as the place to adjust.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 3c45b280-ce20-4746-acec-cf1622444446

📥 Commits

Reviewing files that changed from the base of the PR and between 836718e and 05a3979.

📒 Files selected for processing (5)

• .github/ISSUE_TEMPLATE/bug_report.yml
• .github/issue-labeler.yml
• .github/pull_request_template.md
• .github/workflows/nightly-release-v3.yml
• docs/src/content/docs/contributing.mdx

💤 Files with no reviewable changes (1)

• .github/issue-labeler.yml

✅ Files skipped from review due to trivial changes (3)

• docs/src/content/docs/contributing.mdx
• .github/pull_request_template.md
• .github/workflows/nightly-release-v3.yml

[taliesin-ai]

Port pushed as 3375002.

Depends on #6137. Merged codex/mpress-markdown at 7b0f6dc094bfe7bf693df0320338a9bfc5f86ec8 (no rebase/force push), and retargeted this PR to that branch. Original implementation retained; docs now use M-Press Markdown, including all nine locale counterparts. No retired Starlight sources/build system restored.

Validation: M-Press v1.0.17 build --strict --no-purge-css and check passed (2010 pages; no broken links/assets); all 16 docs script unit tests passed; check_site.py docs/mpress/site passed (2011 HTML pages, all ten languages, zero errors). Diff whitespace check passed against the migration parent. The full upstream translation audit/state repair remains owned by the translation task; no audit exemptions or translation-state changes were made here.

Ported the automatic-changelog/override guidance to contributing/index.md and its nine translations. Preserved APT archive caching, unconditional package installation, newer APT-source pruning, and current template/labeler guidance.

Workflow actionlint: seven existing findings, independently reproduced on both original PR and migration parents; no new findings from this port. These concern unsupported review-event filters, old action versions, and inline head-ref usage; not changed in this docs port.

Required CodeRabbit --plain attempt was unsupported; the single scoped review --uncommitted --light fallback hit the shared OSS rate limit. No credits spent. Manual diff review completed. No implementation blockers remain.