Document shortcuts and the draft composer - #18
Merged
Merged
Conversation
`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
force-pushed
the
claude/docs-shortcut-drafts
branch
from
September 10, 2026 18:31
55227b7 to
cbb71c7
Compare
This branch was successfully deployed
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
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.
Documents the shortcut drafts feature landing in the editor (archival-editor#468).
archival_editor.tomlgains 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:
name/pathkeys, thatshortcutsis reserved at the top level, and howpathaddresses 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.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 reachesdist/docs/llms.txt.🤖 Generated with Claude Code