Skip to content

docs: pages are edited in place, superseding ADR 0001 - #659

Open
botandbang wants to merge 1 commit into
mainfrom
bnb/loc-656-edit-in-place-docs
Open

botandbang wants to merge 1 commit into
mainfrom
bnb/loc-656-edit-in-place-docs

Conversation

@botandbang

Copy link
Copy Markdown
Contributor

What and why

ADR 0001 kept every change under /dashboard so a public page would always be a true preview. That made every edit happen away from the page it changes, and made starting an act or a party a long form instead of the page itself. The decision is now to edit pages in place (LOC-644), so this writes it down before any page moves, and settles the words the design pass (LOC-643) and the page issues will use.

Added:

  • ADR 0017, pages are edited in place: an edit mode in the page's own layout, one Save and Discard with a spinner and a toast in one fixed place, a warning before leaving with unsaved changes, the stale-write check kept, creating as an empty page in edit mode that stays a draft until published, View as visitor, and one edit bar shared by owners and staff whose staff section is logged. It lists what the dashboard keeps and the order pages move in, and records the options turned down: keeping editing in the dashboard, fields always editable with no edit mode, and saving each field as it changes.
  • Glossary entries for Edit mode, View as visitor, Edit bar, Permission (what an admin lets a moderator do, which was called a grant) and Subject (the thing an action, audit entry or follow is about).

Changed:

  • ADR 0012's note on RSVP buttons no longer leans on 0001's exception; it points at 0017 for editing the event.
  • ADR 0001 is marked superseded by 0017.
  • Public page: people who can change it see the controls there, in edit mode.
  • Dashboard: your hub for the inbox, bookings, plans, settings, onboarding and lists; editing happens on the pages.
  • Flag: a flag can say which kinds of page it shows on, so staff can switch it from there.
  • Staff console: the edit bar acts on one thing on screen; the console does everything else.
  • Draft: also covers a new page someone has started and not published.
  • Capability and Grant: both now steer "permission" to the staff meaning.

Removed: nothing.

Fixes LOC-656

How it was tested

Docs only. typos and lychee --offline --include-fragments over the glossary and every ADR pass.

@botandbang
botandbang requested a review from bnb as a code owner November 15, 2026 00:16
@linear-code

linear-code Bot commented Nov 15, 2026

Copy link
Copy Markdown

LOC-656

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Nov 15, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant