ci: apt archive caching + template/docs refresh

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -7,17 +7,15 @@ body:
   - type: markdown
     attributes:
       value: |
-        ***Please note: No bug reports are currently being accepted for Wails v3***
-        ***Please note: No bug reports are currently being accepted for Wails v3***
-        ***Please note: No bug reports are currently being accepted for Wails v3***
+        ***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`.***
         Before submitting this issue, please do the following:
         - Do a web search for your error. This usually leads to a much better understanding of the issue.
         - Prove that the error is indeed a Wails bug and not an application bug, with a specific set of steps to reproduce. 
         - Search the issue tracker using [this link](https://github.com/wailsapp/wails/issues?q=is%3Aissue+).
         - Search the [discussion forums](https://github.com/wailsapp/wails/discussions?discussions_q=type+your+issue+here).
         - Read the [Troubleshooting Guide](https://wails.io/docs/next/guides/troubleshooting).
         - Create a [Minimal Reproducible Example](https://stackoverflow.com/help/minimal-reproducible-example) and link to it in the issue.
-        - If your issue is related to TypeScript generation, please open a ticket and create a PR with a failing test case.
+        - (v2) If your issue is related to TypeScript generation, please open a ticket and create a PR with a failing test case.
         TS tests can be found [here](https://github.com/wailsapp/wails/tree/master/v2/internal/binding/binding_test). Remember to add
         your test to the `binding_test.go` file.
         - Try to fix it yourself. Keep a list of things you have done to fix the problem.   
@@ -75,7 +73,7 @@ body:
     id: systemdetails
     attributes:
       label: System Details
-      description: Please add the output of `wails doctor`.
+      description: Please add the output of `wails doctor` (v2) or `wails3 doctor` (v3).
       render: shell
     validations:
       required: true

.github/issue-labeler.yml

@@ -6,7 +6,6 @@ v2-only:
   - 'version 2'
   - 'wails v2'
   - 'using v2'
-  - 'master branch'
 
 v3-alpha:
   - '\[v3\]'

.github/pull_request_template.md

@@ -6,7 +6,7 @@
 *     YOUR PR MAY BE REJECTED IF IT DOES NOT FOLLOW THESE STEPS     *
 *********************************************************************
 
-- *DO NOT* submit bugs for a source install of v3, ONLY tagged versions, e.g. v3.0.0-alpha.11
+- *DO NOT* submit bugs for a source install of v3, ONLY tagged versions, e.g. v3.0.0-alpha2.113
 - *DO NOT* submit PRs for v3 alpha enhancements, unless you have opened a post on the discord channel.
   All enhancements must be discussed first.
   The feedback guide for v3 is here: https://v3.wails.io/feedback/
@@ -48,7 +48,7 @@ Please paste the output of `wails doctor`. If you are unable to run this command
 
 # Checklist:
 
-- [ ] (v2 only) I have updated `website/src/pages/changelog.mdx` with details of this PR (v3 changelog entries are added automatically)
+- [ ] (v2 only) I have updated `website/src/pages/changelog.mdx` with details of this PR (v3 changelog entries are added automatically on merge; to control the wording, add an entry to `v3/UNRELEASED_CHANGELOG.md`)
 - [ ] My code follows the general coding style of this project
 - [ ] I have performed a self-review of my own code
 - [ ] I have commented my code, particularly in hard-to-understand areas

.github/workflows/build-and-test-v3.yml

@@ -108,16 +108,29 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v4
 
+      - name: Cache apt archives (linux dependencies (GTK4 default))
+        if: matrix.os == 'ubuntu-latest'
+        uses: actions/cache@v4
+        with:
+          path: ~/.apt-archives
+          key: apt-install-linux-dependencies-gtk4-default--${{ github.job }}-${{ runner.arch }}-${{ github.run_id }}
+          restore-keys: |
+            apt-install-linux-dependencies-gtk4-default--${{ github.job }}-${{ runner.arch }}-
+
       - name: Install linux dependencies (GTK4 default)
         if: matrix.os == 'ubuntu-latest'
         run: |
           sudo apt-get update -qq
-          sudo apt-get install -y --no-install-recommends libgtk-4-dev libwebkitgtk-6.0-dev libwayland-dev build-essential pkg-config xvfb x11-xserver-utils at-spi2-core xdg-desktop-portal-gtk
+          sudo mkdir -p $HOME/.apt-archives/partial
+          sudo apt-get -o Dir::Cache::Archives=$HOME/.apt-archives install -y --no-install-recommends libgtk-4-dev libwebkitgtk-6.0-dev libwayland-dev build-essential pkg-config xvfb x11-xserver-utils at-spi2-core xdg-desktop-portal-gtk
+          sudo chown -R $(id -u):$(id -g) $HOME/.apt-archives
 
       - name: Install linux dependencies (GTK3 legacy)
         if: matrix.os == 'ubuntu-latest'
         run: |
-          sudo apt-get install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.1-dev
+          sudo mkdir -p $HOME/.apt-archives/partial
+          sudo apt-get -o Dir::Cache::Archives=$HOME/.apt-archives install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.1-dev
+          sudo chown -R $(id -u):$(id -g) $HOME/.apt-archives
 
       - name: Setup Go
         uses: actions/setup-go@v5
@@ -219,16 +232,29 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Cache apt archives (linux dependencies (GTK4 default))
+        if: matrix.os == 'ubuntu-latest'
+        uses: actions/cache@v4
+        with:
+          path: ~/.apt-archives
+          key: apt-install-linux-dependencies-gtk4-default--${{ github.job }}-${{ runner.arch }}-${{ github.run_id }}
+          restore-keys: |
+            apt-install-linux-dependencies-gtk4-default--${{ github.job }}-${{ runner.arch }}-
+
       - name: Install linux dependencies (GTK4 default)
         if: matrix.os == 'ubuntu-latest'
         run: |
           sudo apt-get update -qq
-          sudo apt-get install -y --no-install-recommends libgtk-4-dev libwebkitgtk-6.0-dev libwayland-dev build-essential pkg-config
+          sudo mkdir -p $HOME/.apt-archives/partial
+          sudo apt-get -o Dir::Cache::Archives=$HOME/.apt-archives install -y --no-install-recommends libgtk-4-dev libwebkitgtk-6.0-dev libwayland-dev build-essential pkg-config
+          sudo chown -R $(id -u):$(id -g) $HOME/.apt-archives
 
       - name: Install linux dependencies (GTK3 legacy)
         if: matrix.os == 'ubuntu-latest'
         run: |
-          sudo apt-get install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.1-dev
+          sudo mkdir -p $HOME/.apt-archives/partial
+          sudo apt-get -o Dir::Cache::Archives=$HOME/.apt-archives install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.1-dev
+          sudo chown -R $(id -u):$(id -g) $HOME/.apt-archives
 
       - name: Setup Go
         uses: actions/setup-go@v5

.github/workflows/build-and-test.yml

@@ -24,17 +24,39 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v4
 
+      - name: Cache apt archives (apt packages (ubuntu-22.04))
+        if: matrix.os == 'ubuntu-22.04'
+        uses: actions/cache@v4
+        with:
+          path: ~/.apt-archives
+          key: apt-install-apt-packages-ubuntu-22-04-libgtk-${{ github.job }}-${{ runner.arch }}-${{ github.run_id }}
+          restore-keys: |
+            apt-install-apt-packages-ubuntu-22-04-libgtk-${{ github.job }}-${{ runner.arch }}-
+
       - name: Install apt packages (ubuntu-22.04)
         if: matrix.os == 'ubuntu-22.04'
         run: |
           sudo apt-get update -qq
-          sudo apt-get install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.0-dev build-essential pkg-config
+          sudo mkdir -p $HOME/.apt-archives/partial
+          sudo apt-get -o Dir::Cache::Archives=$HOME/.apt-archives install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.0-dev build-essential pkg-config
+          sudo chown -R $(id -u):$(id -g) $HOME/.apt-archives
+
+      - name: Cache apt archives (apt packages (ubuntu-24.04))
+        if: matrix.os == 'ubuntu-24.04'
+        uses: actions/cache@v4
+        with:
+          path: ~/.apt-archives
+          key: apt-install-apt-packages-ubuntu-24-04-libgtk-${{ github.job }}-${{ runner.arch }}-${{ github.run_id }}
+          restore-keys: |
+            apt-install-apt-packages-ubuntu-24-04-libgtk-${{ github.job }}-${{ runner.arch }}-
 
       - name: Install apt packages (ubuntu-24.04)
         if: matrix.os == 'ubuntu-24.04'
         run: |
           sudo apt-get update -qq
-          sudo apt-get install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.1-dev build-essential pkg-config libegl1
+          sudo mkdir -p $HOME/.apt-archives/partial
+          sudo apt-get -o Dir::Cache::Archives=$HOME/.apt-archives install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.1-dev build-essential pkg-config libegl1
+          sudo chown -R $(id -u):$(id -g) $HOME/.apt-archives
 
       - name: Setup Go
         uses: actions/setup-go@v4
@@ -127,21 +149,43 @@ jobs:
           go install
           wails -help
 
+      - name: Cache apt archives (apt packages (ubuntu-22.04))
+        if: matrix.os == 'ubuntu-22.04'
+        uses: actions/cache@v4
+        with:
+          path: ~/.apt-archives
+          key: apt-install-apt-packages-ubuntu-22-04-libgtk-${{ github.job }}-${{ runner.arch }}-${{ github.run_id }}
+          restore-keys: |
+            apt-install-apt-packages-ubuntu-22-04-libgtk-${{ github.job }}-${{ runner.arch }}-
+
       - name: Install apt packages (ubuntu-22.04)
         if: matrix.os == 'ubuntu-22.04'
         run: |
           sudo apt-get update -qq
-          sudo apt-get install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.0-dev build-essential pkg-config
+          sudo mkdir -p $HOME/.apt-archives/partial
+          sudo apt-get -o Dir::Cache::Archives=$HOME/.apt-archives install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.0-dev build-essential pkg-config
+          sudo chown -R $(id -u):$(id -g) $HOME/.apt-archives
 
 #      - name: Install linux dependencies ( 22.04 )
 #        if: matrix.os == 'ubuntu-22.04'
 #        run: sudo apt-get update -y && sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev build-essential pkg-config
 
+      - name: Cache apt archives (apt packages (ubuntu-24.04))
+        if: matrix.os == 'ubuntu-24.04'
+        uses: actions/cache@v4
+        with:
+          path: ~/.apt-archives
+          key: apt-install-apt-packages-ubuntu-24-04-libgtk-${{ github.job }}-${{ runner.arch }}-${{ github.run_id }}
+          restore-keys: |
+            apt-install-apt-packages-ubuntu-24-04-libgtk-${{ github.job }}-${{ runner.arch }}-
+
       - name: Install apt packages (ubuntu-24.04)
         if: matrix.os == 'ubuntu-24.04'
         run: |
           sudo apt-get update -qq
-          sudo apt-get install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.1-dev build-essential pkg-config libegl1
+          sudo mkdir -p $HOME/.apt-archives/partial
+          sudo apt-get -o Dir::Cache::Archives=$HOME/.apt-archives install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.1-dev build-essential pkg-config libegl1
+          sudo chown -R $(id -u):$(id -g) $HOME/.apt-archives
 
 #      - name: Install linux dependencies ( 24.04 )
 #        if: matrix.os == 'ubuntu-24.04'

.github/workflows/cross-compile-test-v3.yml

@@ -91,10 +91,20 @@ jobs:
           version: 3.x
           repo-token: ${{ secrets.GITHUB_TOKEN }}
 
+      - name: Cache apt archives (cross-compile deps)
+        uses: actions/cache@v4
+        with:
+          path: ~/.apt-archives
+          key: apt-cross-compile-${{ github.job }}-${{ runner.arch }}-${{ github.run_id }}
+          restore-keys: |
+            apt-cross-compile-${{ github.job }}-${{ runner.arch }}-
+
       - name: Install Linux dependencies
         run: |
           sudo apt-get update -qq
-          sudo apt-get install -y --no-install-recommends libgtk-4-dev libwebkitgtk-6.0-dev libgtk-3-dev libwebkit2gtk-4.1-dev libwayland-dev build-essential pkg-config
+          sudo mkdir -p $HOME/.apt-archives/partial
+          sudo apt-get -o Dir::Cache::Archives=$HOME/.apt-archives install -y --no-install-recommends libgtk-4-dev libwebkitgtk-6.0-dev libgtk-3-dev libwebkit2gtk-4.1-dev libwayland-dev build-essential pkg-config
+          sudo chown -R $(id -u):$(id -g) $HOME/.apt-archives
 
       - name: Install Wails3 CLI
         working-directory: v3

.github/workflows/nightly-release-v3.yml

@@ -1,4 +1,4 @@
-name: Nightly Release v3-alpha
+name: Nightly Release v3
 
 on:
   schedule:

.github/workflows/pr-master.yml

@@ -65,17 +65,39 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v4
 
+      - name: Cache apt archives (linux dependencies (22.04))
+        if: matrix.os == 'ubuntu-22.04'
+        uses: actions/cache@v4
+        with:
+          path: ~/.apt-archives
+          key: apt-install-linux-dependencies-22-04-libgtk--${{ github.job }}-${{ runner.arch }}-${{ github.run_id }}
+          restore-keys: |
+            apt-install-linux-dependencies-22-04-libgtk--${{ github.job }}-${{ runner.arch }}-
+
       - name: Install linux dependencies (22.04)
         if: matrix.os == 'ubuntu-22.04'
         run: |
           sudo apt-get update -qq
-          sudo apt-get install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.0-dev build-essential pkg-config
+          sudo mkdir -p $HOME/.apt-archives/partial
+          sudo apt-get -o Dir::Cache::Archives=$HOME/.apt-archives install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.0-dev build-essential pkg-config
+          sudo chown -R $(id -u):$(id -g) $HOME/.apt-archives
+
+      - name: Cache apt archives (linux dependencies (24.04))
+        if: matrix.os == 'ubuntu-24.04'
+        uses: actions/cache@v4
+        with:
+          path: ~/.apt-archives
+          key: apt-install-linux-dependencies-24-04-libgtk--${{ github.job }}-${{ runner.arch }}-${{ github.run_id }}
+          restore-keys: |
+            apt-install-linux-dependencies-24-04-libgtk--${{ github.job }}-${{ runner.arch }}-
 
       - name: Install linux dependencies (24.04)
         if: matrix.os == 'ubuntu-24.04'
         run: |
           sudo apt-get update -qq
-          sudo apt-get install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.1-dev build-essential pkg-config
+          sudo mkdir -p $HOME/.apt-archives/partial
+          sudo apt-get -o Dir::Cache::Archives=$HOME/.apt-archives install -y --no-install-recommends libgtk-3-dev libwebkit2gtk-4.1-dev build-essential pkg-config
+          sudo chown -R $(id -u):$(id -g) $HOME/.apt-archives
 
       - name: Setup Go
         uses: actions/setup-go@v5

docs/src/content/docs/contributing.mdx

@@ -84,9 +84,9 @@ go test -cover ./...
 ### Create a Branch
 
 ```bash
-# Update main
-git checkout main
-git pull upstream main
+# Update master
+git checkout master
+git pull upstream master
 
 # Create feature branch
 git checkout -b feature/my-feature
@@ -100,6 +100,10 @@ git checkout -b feature/my-feature
 4. **Run tests** to ensure nothing breaks
 5. **Commit changes** with clear messages
 
+v3 changelog entries are generated automatically when your PR merges. To
+control the wording, add your own entry to `v3/UNRELEASED_CHANGELOG.md`
+and the automation will use it instead.
+
 ### Commit Guidelines
 
 ```bash