fix(site): restore full shell width for documentation prose#217
Merged
Conversation
Remove the 65ch text column cap so body copy matches headings and diagrams across the site shell.
Add site-specific plain-language guides and shorter parameter hints in the site generator while keeping MCP source schemas authoritative.
Fold the one useful fact — only new binding-fidelity findings fail — into the guard table row instead of a separate history section.
Introduce a dedicated guide page for workflows, activities, step kinds, techniques, resources, binding, and runtime delivery; wire it into the guide sequence and cross-link from Concepts and the home page.
Illustrate workflow manifest contents, activity step/transition structure, and technique file anatomy with resolution and composition.
Relocate to specs/workflows.html in the top-bar Architecture section, update cross-links, and restore the guide sequence to four pages.
Separate generic structure diagrams from work-package examples, add binding and resource figures, and write each section in longer plain language.
Use bulleted prose and clearer SVG layouts on Workflows and Resolution pages, split API nested parameters into a scoped table, link Home to index.html to avoid directory listings, and move Design rationale into the Guide section.
Remove redundant home sections, shorten workflows and rationale pages with canonical links, and dedupe verify steps between getting-started and ide-setup.
Add a rationale section comparing technique structure to conventional agent skills, and cross-link from Concepts.
Reorganize nav (definitions, specifications, design), consolidate getting started, refine the home run diagram and copy, and move internals under design.
Show activity → step → technique → resource chain with clearer arrows, correct follows/apply/consult labels, and remove redundant in-diagram note.
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
1 participant
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.
Summary
65chmax-width rules added in the documentation site readability pass so body copy, hero lede, notes, and disclosure panels use the full page shell again.--shelllayout container; only the narrowed text column is reverted.Test plan
npm run check:site