docs: rework all pages to Artix Wiki quality

- index.md: add download link + stable release announcement
- building.md: add troubleshooting section (cache, squashfs, compression)
- ci.md: IA upload enabled, push trigger removed (manual dispatch only)
- development.md: add all gotchas from AGENTS.md (SDDM theme ordering,
  pipewire launcher, antergos-release in basestrap, CI changes)
- installer.md: document fixed issues (audio, SDDM, os-release)
- packages.md: add pipewire fork, antergos-sddm-theme, antergos-release
- launcher.md: expand with module configs
- init-systems.md: Chimera uses dinit, OpenRC marked as broken
- openrc.md: add broken warning banner
- wallpapers.md: default is antergos-wallpaper.png (not Adwaita Morning)
- overlays: clean up explanations and symlink behavior
- desktop-environments.md: add Discover note, clean up GNOME entry
- dinit.md, runit.md, s6.md: polish and add troubleshooting sections

docs/ci.md

@@ -10,22 +10,26 @@ Two GitHub Actions workflows:
 
 ## Build ISO (`build.yml`)
 
-Triggers on push/PR to `master`. Runs in an `artixlinux/artixlinux:base` container.
+Triggers on **manual `workflow_dispatch`** only (push to master does NOT trigger a build). Runs in an `artixlinux/artixlinux:base` container.
+
+### Steps
 
-Steps:
 1. Install dependencies (artools, squashfs-tools, git, sudo, python)
 2. Set `WORKSPACE_DIR` to the checkout path
-3. Override pacman config with `[antergos-pkgs]` repo
+3. Override pacman config with `[antergos-pkgs]` repo (`pacman.conf.d/iso-x86_64.conf`)
 4. Mount a 12 GB tmpfs at `/var/lib/artools/buildiso`
 5. Run `./buildiso -p antergos`
-6. Upload the ISO directory as a build artifact
+6. Upload the ISO and checksum as build artifacts
 
 ### Internet Archive upload
 
-Currently **disabled** (`if: false`) until ISO is stable. When enabled, uploads the built ISO to the Internet Archive with metadata:
+Uploads the built ISO to the Internet Archive with:
 
-- Collection: `open_source_software`
-- Access keys: `IA_ACCESS_KEY`, `IA_SECRET_KEY` (repo secrets)
+- **Collection**: `open_source_software` (Community Software, _not_ Community Texts)
+- **Identifier**: `antergos-next-YYYYMMDD-<run_number>` (e.g. `antergos-next-20260711-162`)
+- **Credentials**: `IA_ACCESS_KEY` and `IA_SECRET_KEY` (repo secrets)
+
+The `-<run_number>` suffix guarantees unique identifiers across CI runs. If two pushes produce the same date, they still get different archive entries.
 
 ### Secrets
 
@@ -36,8 +40,14 @@ Currently **disabled** (`if: false`) until ISO is stable. When enabled, uploads
 
 ## Deploy docs (`pages.yml`)
 
-Triggers on push to `master` only when files under `docs/` change. Builds a Jekyll site from `docs/` using the Just the Docs theme and deploys to GitHub Pages.
+Triggers on push to `master` _only_ when files under `docs/` change. Builds a Jekyll site from `docs/` using the Just the Docs theme and deploys to GitHub Pages.
 
 ## antergos-packages CI
 
-Separate workflow in the [antergos-packages](https://github.com/Antergos-NeXT/antergos-packages) repo. Builds all packages listed in `packages.yaml` and publishes them to GitHub Pages as a pacman repo.
+Separate workflow in the [antergos-packages](https://github.com/Antergos-NeXT/antergos-packages) repo. Builds all packages listed in `packages.yaml` and publishes them to GitHub Pages as a pacman repository.
+
+## Safety notes
+
+- CI does NOT run on push — only manual dispatch. This prevents accidental ISO floods.
+- Internet Archive upload uses a unique identifier per run, so re-running CI won't overwrite a previous release.
+- Both `IA_ACCESS_KEY` and `IA_SECRET_KEY` must be set as repo secrets for the upload step to succeed.