WIP: docs nav restructure — Cooperative / Get Involved / Tools (proposal) - #42
Draft
bagelface wants to merge 4 commits into
Draft
WIP: docs nav restructure — Cooperative / Get Involved / Tools (proposal)#42bagelface wants to merge 4 commits into
bagelface wants to merge 4 commits into
Conversation
Reorganizes the docs to a five-entry sidebar: two standalone pages (Our Manifesto, Contact & Links) and three sections (Bread Cooperative, Get Involved, Tools and Mechanisms), each with named sub-sections. Content moves: - about/ and organization/ retired in favour of cooperative/, get-involved/, and tools/ - "Bread Constitution" renamed "Guiding Principles" to stop it competing with the Manifesto - Solidarity Fund index, Yield Governance, and Voting Power merged into a single "How it Works" - Connecting a Wallet, How to Burn, and the Gnosis on-ramps merged into "How to Bake $BREAD" - Operational Annex dissolved into Core Team, Finances, and the four Member Projects pages - stacks.md split into "What is a savings circle?" and "How Stacks works" New pages: Finances (Bread Coop Core vs. Solidarity Fund treasuries, with Safe links), Core Team, Eligibility, Onboarding, How to Get Started, and an expanded Tools overview. public/_redirects is rewritten rather than appended to: every legacy rule from all four previous URL generations now resolves to a live Gen-5 URL, and a Gen-4 to Gen-5 block is added. Verified no rule is shadowed by a real page, no rule targets another rule's source, and every target exists. Keystatic collections rebuilt from a shared schema factory so the four docs sections stay in sync. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
✅ Deploy Preview for bread-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Replaces bare contact@bread.coop addresses in prose with links to /contact/, so the contact page stays the single place we maintain addresses and social links. The address itself is untouched on the contact page and in the Bread Core Team project card, where it is the payload rather than a call to action. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Get Involved was the only section without a landing page, so its dropdown opened straight into sub-sections while Bread Cooperative and Tools each led with an Overview. The page also does real work: the two routes in — contributing as an individual and joining as a member project — have different audiences and different gates (one has none, one needs a nomination and a unanimous vote), which was not stated anywhere before. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Every bullet and numbered list in markdown content was rendering without
markers or indentation.
Tailwind's Preflight sets `ol,ul,menu{list-style:none}` and zeroes padding
via its universal reset. Starlight styles prose lists on the assumption
that browser defaults are intact and sets neither property itself, and
@astrojs/starlight-tailwind restores borders and fonts but not lists — so
nothing put the markers back.
Restores them for .sl-markdown-content only, excluding components that
manage their own list styling (<Steps>, <Tabs>, .not-content). Using
`revert` hands the marker back to the UA stylesheet, so nested lists get
the disc/circle/square progression for free.
The homepage already worked around this locally in .link-list; that rule
is unlayered and unaffected, and now matches sitewide behaviour.
Verified in headless Chrome: bullets, ordered lists, and lists inside
aside blocks all render.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
bagelface
force-pushed
the
docs/restructure-nav-gen5
branch
from
August 27, 2026 15:56
a2c1b61 to
fd27c95
Compare
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
1 participant
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.
What this does
Reorganizes the sidebar into two standalone pages and three sections:
about/andorganization/are retired. New roots:cooperative/,get-involved/,tools/, plusmanifesto.mdandcontact.mdat the top level.Content moves
Merged
stacks.mdsplit into the two Stacks pagesRenamed
New
Redirects
public/_redirectswas rewritten rather than appended to — every legacy rule from all four previous URL generations now resolves to a live URL, plus a new Gen-4 → Gen-5 block. Checked programmatically: no rule is shadowed by a real page, no rule targets another rule's source, every target exists.Also updated
Sidebar config, Keystatic collections (four docs collections now built from one shared schema factory), homepage link lists,
AGENTS.md,README.md.Verification
npm run buildpasses. All 43 built pages checked — every internal link and every anchor resolves.Open questions / things to push back on
draft: trueand never had one. Currently points atcontact@bread.coop+ Discord. Needs the real URL.how-to-become-a-member-project.mdwas a draft; it's now live across Eligibility / Responsibilities / How to Apply. I dropped its broken placeholders ([add new crowdstaking], bare emoji links) and fixed a stale Guild URL — but the content itself should get a read before this ships.cooperative/rather thanbread-cooperative/— the latter collides with a Gen-1 wildcard redirect.Unrelated, noticed in passing: the
starlight-page-actions"raw Markdown" links (/manifesto.mdetc.) point at files the build doesn't emit. Pre-existing, untouched here.🤖 Generated with Claude Code