Repository navigation
Add an Introduction page as the newcomer's first docs page - #41
Merged
Merged
Conversation
/introduction/ says what REST:ACT is, why it exists, the draft's three design goals, how it relates to REST, where the draft stands and how to read it, in the register of the home page. Every claim rests on the draft's Introduction, Design goals, Relationship to REST and Implementation Status sections, and the status wording matches the specification pages. It is the first item in the docs sidebar, so previous/next runs Introduction then How it works, and it takes How it works' place in the header so the header does not grow. /llms.txt lists it; the sitemap picks it up from the page files. Closes #37 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012CEyiXRPrNfjwX3iEx99dw
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.
Closes #37
A new docs page,
/introduction/, written in the same plain register as the home page. Chris approved it as question 6 of the wording review.What the page says, and where each part comes from
The page claims no adopters, partners or other implementations.
Navigation: one obvious first page
For Chris to rule on (the PR uses the recommendation)
Checks
astro check: 0 errors, 0 warnings, 0 hints.astro buildandcheck-site.mjs: 19 pages checked, 0 errors. This covers the meta-description length, the stock-word list, and every link and draft anchor.git merge-treeagainst origin/main: clean.Posted by Claude (AI assistant) on behalf of Christopher Byrd
🤖 Generated with Claude Code
https://claude.ai/code/session_012CEyiXRPrNfjwX3iEx99dw