Skip to content

Document shortcuts and the draft composer - #18

Merged
jesseditson merged 1 commit into
mainfrom
claude/docs-shortcut-drafts
Sep 10, 2026
Merged

jesseditson merged 1 commit into
mainfrom
claude/docs-shortcut-drafts

Conversation

@jesseditson

Copy link
Copy Markdown
Collaborator

Documents the shortcut drafts feature landing in the editor (archival-editor#468).

archival_editor.toml gains a top-level [[shortcuts]] array naming the lists worth one tap from anywhere in the editor. Configuring one puts a button in the bottom right corner of every editor screen that opens a full-screen composer for a new entry, with a publish button that writes and deploys it in one step.

Three sections on the Archival Editor Configuration page:

  • Shortcuts — the name / path keys, that shortcuts is reserved at the top level, and how path addresses a list: an object type, the filename when that type holds many objects, then child lists with the index of the entry descended through between them. Also what makes a shortcut resolve to nothing, and that correcting the path brings it and its drafts back.
  • Drafts — the badge and menu, save / cancel / publish, paging between drafts, that a draft lives on the device and is never a pending change to the site. Plus what publishing derives the commit message and the new filename from, and that publishing a draft publishes whatever else was unsynced.
  • Changing a schema under an open draft — a field the type no longer declares, or one whose type changed incompatibly, is dropped on open; everything still valid is kept.

The existing views content moves out of the page description into an Object views section, so each topic gets its own sidebar entry and the page matches the description-plus-sections shape every other doc with sections uses. Its wording is unchanged.

Verified with archival build: the three sections render with anchors, the sidebar picks them up, and the new content reaches dist/docs/llms.txt.

🤖 Generated with Claude Code

`archival_editor.toml` grew a top-level `[[shortcuts]]` array naming the
lists worth one tap from anywhere in the editor. This documents the
config, the addressing `path` uses, and the composer the button opens:
what saving, cancelling and publishing do, how a draft persists, what the
generated commit message and filename are derived from, and how a draft
is reconciled when the schema moves under it.

The existing views content moves from the page description into a
section, matching the shape every other doc with sections uses and
giving each topic a sidebar entry. Its wording is unchanged.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@jesseditson
jesseditson force-pushed the claude/docs-shortcut-drafts branch from 55227b7 to cbb71c7 Compare September 10, 2026 18:31
@jesseditson
jesseditson merged commit b77c77b into main Sep 10, 2026
2 checks passed

This branch was successfully deployed

1 active deployment
archival.dev — cbb71c73 Deployed Sep 10, 2026 by jesseditson via Publish to Cloudflare Pages #211
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant