docs(guides): move the README workflow tours into docs/guides pages #316

Closed
opened 2026-07-21 02:35:12 +00:00 by hexajon · 0 comments
hexajon commented 2026-07-21 02:35:12 +00:00 (Migrated from codeberg.org)

The README's "A tour of the workflows" sections (ship-a-branch, land-a-whole-batch, one-repo-many-hands, ask-the-backlog) are the only place those walkthroughs exist. madtea.lol's homepage cards deep-link into the README on Codeberg today because there is nothing on-site to point at - the README itself is not synced.

Split the four tours into docs/guides/ pages (e.g. tour-finish.md, tour-orchestrate.md, tour-worktrees.md, tour-issue-rank.md) and have the README link them instead of inlining. The guides section syncs to the site automatically, so the tours then render on madtea.lol with no site-side work beyond repointing four links.

Acceptance: four tour pages under docs/guides/ carrying the README content; README links them; no walkthrough text lives only in the README.

The README's "A tour of the workflows" sections (ship-a-branch, land-a-whole-batch, one-repo-many-hands, ask-the-backlog) are the only place those walkthroughs exist. madtea.lol's homepage cards deep-link into the README on Codeberg today because there is nothing on-site to point at - the README itself is not synced. Split the four tours into `docs/guides/` pages (e.g. `tour-finish.md`, `tour-orchestrate.md`, `tour-worktrees.md`, `tour-issue-rank.md`) and have the README link them instead of inlining. The guides section syncs to the site automatically, so the tours then render on madtea.lol with no site-side work beyond repointing four links. Acceptance: four tour pages under docs/guides/ carrying the README content; README links them; no walkthrough text lives only in the README.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
sixfold-space/madtea#316
No description provided.