docs: correct the filename-mapping claim — GitHub double-spaces the title
The previous commit overstated one of the three results. `Editing--Attachments`
does not render as a nested title on github.com; GitHub substitutes each `-`
with a space, giving the literal double-spaced title "Editing Attachments".
Control: `Getting-Started` titles as "Getting Started".
The hierarchy is real but comes only from the generated _Sidebar.md. ADR-0001's
premise (the native UI cannot show directory hierarchy) survives; what it never
recorded is the cosmetic cost of the scheme in that same UI.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QMTyDv9CoJo5PfeNzyp519
edd2706
docs: record the first live GitHub wiki observations
Publishing this wiki and reading the rendered HTML back retired three of the
four GitHub-behaviour assumptions the project has carried untested since
inception: HTML comments are stripped, _Sidebar.md renders on every page, and
the flat `--` filename scheme maps to nested titles as designed.
The fourth — token-authenticated clone and push of <repo>.wiki.git, ADR-0002 —
is NOT confirmed. This wiki is pushed over SSH.
Compatibility-and-Limits.md and Verification.md are updated together, because
a limits page left asserting the negation is the exact drift this wiki was
just audited for.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QMTyDv9CoJo5PfeNzyp519
4e3645f
docs(wiki): correct three stale pages against the code and add four
Commit 7fbc401 moved subtree-move and conflict classification to Built on
Roadmap.md but left the pages that advertise *limits* asserting the negation.
A reader landing on Editing or Compatibility was told BerryWiki cannot do
things it does.
Corrections, each verified against origin/main at 0cf0066:
- Getting-Started: Rust 1.85 -> 1.89. Cargo.toml declares
rust-version = "1.89" and CI carries a 1.89.0 matrix leg. (The stale figure
almost certainly came from berrywiki-serve's own crate description, which
still says 1.85 and is a separate defect in the main repo.)
- Editing: drop "Moving a page ... is not implemented" (move_page is
implemented) and "Committing and pushing. Use git." (commit-on-save is the
default and /changes does fetch/ff/push). Keep the --github read-only entry,
and add the honest residual: body and metadata conflicts are not merged for
you.
- Compatibility and Limits: drop the subtree-move row; rewrite the conflict
row, which said conflicts are "not yet classified or presented per page"
when ConflictKind has seven variants and they are shown three-way per page.
New pages, each documenting something no existing page did:
- Editing--Attachments: the nine-entry allowlist, the 1 MiB cap, the
assets/<page-id>/ layout, why SVG/HTML/JS are refused, and 404-not-403.
- Syncing-and-Conflicts: fetch/fast-forward/push with no fourth operation,
why conflicts are read from the git index rather than the marker-laced
worktree, all seven ConflictKind variants, and why only Sidebar is settled
automatically.
- Diagnostics: the eleven dotted codes split by severity, and the 0/1/2 exit
codes (only graph.duplicate-id and graph.cycle are errors).
- Verification: what is checked automatically, the fourteen a11y structural
rules, and what has never been verified at all - no live GitHub wiki, MSRV
declared but never built, no screen-reader test, no proofs, ADR-0001 and
ADR-0002 still Proposed. Points at docs/AFFIRMATION.adoc.
_Sidebar.md is regenerated by `berrywiki sidebar --write`, not hand-edited, so
Home's claim that BerryWiki generates it stays true. `berrywiki check` reports
13 pages, 0 errors, 0 warnings.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QMTyDv9CoJo5PfeNzyp519
a5aebef
docs(wiki): move subtree-move and conflict classification to Built
Both packages are *DONE* in docs/execution/work-packages.adoc (P2-move,
P3-conflict, both 2026-09-02) but this page still listed them under "Next",
understating the project to anyone reading the published wiki.
- Subtree move and conflict classification move to Built, each described by
what actually landed rather than by what the package was called.
- The accessibility gate is added to Built: fourteen structural rules over
every rendered route. It was built on 2026-09-03 and had never appeared here.
- "Never merges two authored sides" is restated as a deliberate limit rather
than a gap, which is what the package's own stop-rule says.
- Zim import is promoted from Later to Next, matching the tracker.
- The unrun accessibility walkthrough is stated explicitly under Next, so no
screen-reader claim is implied anywhere on this wiki.
Verified with `berrywiki check` (9 pages, 0 errors, 0 warnings) and the
generated sidebar is byte-identical, so _Sidebar.md needs no regeneration.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016CVTLf6maUsJSiNDCgWdFu
7fbc401
docs(wiki): correct the default port, the publishing model, and the Proposed-ADR summary
Three claims contradicted the code.
Getting Started sent the reader to http://127.0.0.1:8080. DEFAULT_ADDR is
127.0.0.1:23779, chosen from an IANA-unassigned block precisely to avoid the
8080/3000 class. The page now gives the real port, says it listens on loopback
TCP only, and names --addr.
"Publishing your changes" said BerryWiki writes to your working copy and that
committing is yours to do, with a git add -A recipe. The CLI's own USAGE says
the opposite is the default: a git working tree is served with commit-on-save,
one commit per save, sidebar included, and /changes offers fetch, fast-forward
and push, never a merge or a force. A reader following the old page would have
hand-committed on top of BerryWiki's own commits. The section is rewritten from
USAGE and now documents --no-commit and --author, and states plainly that what
is missing is resolving a conflict, not committing.
The Decisions summary asserted both Proposed ADRs wait on "the same thing" and
named ADR-0002's provisional answer as a token-through-the-environment mirror.
ADR-0002 is the authentication strategy: the token is the push credential, kept
out of the clone URL, not the read-only --github mirror. Both ADRs now state
what they actually decide and what evidence each is waiting on.
Verified: berrywiki check 0 errors / 0 warnings; berrywiki sidebar output
byte-identical to _Sidebar.md.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QMTyDv9CoJo5PfeNzyp519
1c88180
docs(wiki): document backup/restore/import; correct the Proposed-ADR claim
Getting Started covered only check, sidebar and serve. Four feature areas
landed on 2026-09-03 with an ADR each and had no usage anywhere in the wiki:
backup, restore and import now have sections written from the CLI's own USAGE
text, preserving each command's refusals verbatim (backup refuses a dirty tree,
restore refuses a non-empty folder, import writes nothing without --apply and
refuses rather than overwrite).
Decisions.md claimed "nothing in the codebase assumes an answer to either"
Proposed ADR. That was mine, not the ADRs', and it is false: the code already
implements ADR-0001's `--` separator and ADR-0002's environment-token mirror.
They are provisional, not unimplemented.
Compatibility said conflicts are "detected and shown" while Roadmap listed
per-page presentation as unbuilt. Both are true and now say so: conflicts_page
renders one /conflicts view for the whole wiki, not a per-page one.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QMTyDv9CoJo5PfeNzyp519
3c0fa69
docs: correct the wiki against the code, and index the decisions
The wiki was last written on 2026-08-07; the repository has moved since, and
in three places the wiki now told readers something that is no longer true.
Every correction below was checked against the code or the ADR it cites, not
inferred.
Architecture
Eleven crates -> thirteen. berrywiki-a11y and berrywiki-import (both added
2026-09-03) were missing entirely; both are described from their own doc
comments, including the parts that are limitations: the a11y crate audits
structure only and BerryWiki has still never been tested with a screen
reader, and the importer refuses .ctb/.ctz/.ctx by name rather than
half-handling them.
ADR-0007 was ruled, and the wiki still said it was open
Architecture and Roadmap both described generated client script as an
unruled question. It was accepted on 2026-09-03 (generated-only, under a
provenance manifest). Stated as ruled *and* as not yet acted on: nothing
shipped changed that day, the no-<script> test is unchanged byte-for-byte,
and the manifest gate must exist before it may be relaxed. The parked UX
work stays parked.
The writer lock exists, and three pages denied it
Compatibility said "no lock between processes", Editing--Drafts said two
serve instances are unsafe, and Roadmap still listed the lock as missing.
ADR-0008's OS advisory lock is implemented and taken by serve and by CLI
mutations. Corrected without overclaiming: the lock does not cover writers
that are not BerryWiki, which is what the stale-write fingerprint still
guards.
Also moved to Built, having been verified in the source: attachments, tags,
per-page history, backup/restore, CherryTree .ctd import, and in-app
commit/fetch/fast-forward/push. In-app conflict *resolution* genuinely does
not exist and is left stated as absent.
New Decisions page indexing all sixteen ADRs with real statuses (0001 and
0002 are still Proposed; the rest accepted), plus why ADR-0003+0007, 0008 and
0015 explain the shape of the code.
_Sidebar.md was regenerated with `berrywiki sidebar --write` rather than
edited by hand, since it is a generated file. `berrywiki check` reports
9 pages, 0 errors, 0 warnings, and every internal link resolves. The new
page's id continues the hand-minted 0197a1c0-…-00000000000N series of its
siblings.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QMTyDv9CoJo5PfeNzyp519
cee10d8
docs: real wiki, authored in BerryWiki's own format
Replaces the one-line default stub with eight pages covering getting started,
the page format, editing, architecture, limits and the roadmap.
The wiki dogfoods the tool: every page carries a BerryWiki metadata block,
the hierarchy comes from parent ids rather than filenames, and _Sidebar.md
was generated by 'berrywiki sidebar --write'. 'berrywiki check' reports 8
pages, 0 errors, 0 warnings.
Compatibility-and-Limits states plainly that no GitHub Wiki behaviour the
design relies on has been verified against a live wiki.
ac32d68