docs: public repo setup refresh and update Topgrade steps - #353
Merged
timmo001 merged 2 commits intoAug 22, 2026
Merged
Conversation
setup-public-repo now runs pacman -Sy after registering the timmo repository so init can install packages from the refreshed database. Update the packages page, CLI spec, and generated command reference. Co-authored-by: Aidan Timson <aidan@timmo.dev>
The split update wrapper exposes individual Topgrade steps through Gum. Document the full step list and matching topgrade --only names. Co-authored-by: Aidan Timson <aidan@timmo.dev>
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
dotfiles-docs | 6db7b2a | Commit Preview URL Branch Preview URL |
Aug 22 2026, 06:08 AM |
timmo001
approved these changes
Aug 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documentation-only updates from the weekly docs automation pass.
Docs added/updated
configuration/packages.md— documents thatdot setup-public-reporunspacman -Syafter registering the signedtimmorepository so package databases include the new repo beforedot initinstalls from.dot-public-packages.dot/shell.md— lists every selectable Topgrade step exposed by theupdateGum wrapper, with the matchingtopgrade --onlystep names.dot/commands.md(generated) anddot/src/cli/spec.ts— align thesetup-public-repocommand reference with the pacman refresh behaviour.Codepaths covered
dot/src/commands/SetupPublicRepo.ts— post-registrationpacman -Syadded in init fixesscripts/.local/bin/update— per-step Topgrade selection from the split-update workflowKnowledge gaps addressed
updatehelper documented default selections but not the full list of optional Topgrade steps (ProtonPlus, firmware, Rustup, TLDR, Neovim, containers, Claude Code, Claude Code plugins, uv).Validation
mise run docs:genmise run docs:build(starlight-links-validator passed)