Repository navigation
Home page: plain wording for a general reader - #38
Merged
Merged
Conversation
Rewrite the home page opening in plain language: the problem first, then what REST:ACT lets a user do, then one paragraph naming the technology. "What it is for" moves ahead of the request demo and opens with why client code is wanted. The six-item mandatory-core grid, which no longer matched the draft's nine items, becomes four plain rules on how the server confines uploaded code, each linked to its draft section, with the full list left to /spec/. Fix limit claims that disagreed with the draft and restactd: a verb that runs past its wall-clock limit gets 504, not 408 (Security, Get started, restactd), and the compute limit is recommended, not required (Security, Compare, the /spec/ section gist). Part of #37 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012CEyiXRPrNfjwX3iEx99dw
From the text review: the runs-as-caller rule now says "by default" and names the owner opt-in the draft allows, since the page's own social-site example is that case. The shared deadline applies where a server lets verbs call each other on it, matching the draft's optional composition and its fresh budget across servers. The example lead names the second demo request and says authentication is off rather than "no sign-in". Security and Compare drop the last two places that stated the compute limit as required, and /llms.txt follows the new home-page opening. Part of #37 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012CEyiXRPrNfjwX3iEx99dw
Brings in the limit fixes from #39, which this branch also carried. llms.txt.ts keeps this branch's summary, the short form of the new home-page opening. 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.
Part of #37
Rewrites the home page so a general technical reader can follow it, and fixes limit claims that had drifted from the draft and from restactd. This is a proposal for review: the wording is a matter of taste, so it stays a draft.
Home page
Accuracy fixes elsewhere
504, not408. That matches the draft's Resource Limits section and restactd'stimeoutmapping. Fixed on Security (the limits table), Get started and restactd.Checks
astro check: 0 errors, 0 warnings, 0 hints.astro buildandcheck-site.mjs: 18 pages checked, 0 errors. These are the stepspnpm verifyruns. They were run directly because a mise pnpm shim breaks the nestedpnpm runhere.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