feat(website): quickstart guide with hero hint and bottom CTA#185
Merged
Conversation
Two homepage surfaces lead to a new standalone /quickstart page: - a subtle "…then follow our short quickstart guide →" line right under the install command in the Hero - a "Ready to try it?" section at the bottom of the landing with a single prominent CTA button The /quickstart page itself is one long MDX with six sections — install, init, your first Charter, AILOG, status & validate, and the multi-model audit cycle — designed for a developer who has decided to try the tool and wants the shortest end-to-end path. Around 10–15 minutes of reading, heavy on copy-paste-able commands, deliberately not docs-depth. EN only for now; es/zh-CN fall back gracefully. Five new home-surface strings are translated to es and zh-CN in this PR. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…uickstart hint Two small Hero tweaks: - add an "Install the CLI in one line" eyebrow above the curl block (translated to es and zh-CN) so the command has a header that names what it does - bump the bottom margin under the quickstart hint from 0 to 1rem so the "Read the docs / Read the chronicle" buttons aren't hugging the hint line Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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.
Summary
Adds a standalone
/quickstartpage and two homepage surfaces that lead to it:/quickstart. Targets the visitor who reached the bottom of the page without quitting.The
/quickstartpage is one long MDX with six sections, designed for a developer who has decided to try the tool and wants the shortest end-to-end path:curlone-liner,straymark --version, update commands.straymark init, the.straymark/tree explained./straymark-charter-newskill, the four template sections.straymark status,straymark validate --staged, a two-line pre-commit hook.~10–15 min of reading, heavy on copy-paste-able commands, deliberately not docs-depth. The right-side TOC is Docusaurus' native one.
Why
The site reads at two speeds: people who skim (Hero + workflow blueprint + features grid) and people who decide to try it (Hero install + this guide). Until now there was nothing for the second group — they had to land in the docs and assemble the happy path themselves. The guide is the missing bridge between "I'll try it" and "I have a closed Charter".
Asciinema demo is a separate, follow-up PR (different purpose: a "wow" surface for visitors who haven't decided yet).
i18n
hero.quickstartHint,hero.quickstartHint.link,gettingStarted.title,gettingStarted.body,gettingStarted.cta) are translated toesandzh-CN./quickstart.mdxpage itself is English-only in this PR; Docusaurus falls back gracefully under/es/quickstartand/zh-CN/quickstart(visitor sees English content inside their localized chrome). Translation of the guide is a deliberate follow-up.Test plan
npm run buildsucceeds for all three locales (verified locally —build/quickstart.html,build/es/quickstart.html,build/zh-CN/quickstart.htmlexist)./,/es/,/zh-CN/: hero shows the subtle quickstart link under the install command; bottom section shows the CTA in the correct language.🤖 Generated with Claude Code