docs: SEO/indexing setup, landing page, and 0.2.0-beta.0 doc updates - #3
Open
Demali-876 wants to merge 5 commits into
Open
docs: SEO/indexing setup, landing page, and 0.2.0-beta.0 doc updates#3Demali-876 wants to merge 5 commits into
Demali-876 wants to merge 5 commits into
Conversation
Add a standalone marketing landing page at / (src/pages/index.astro); docs keep their existing routes. index.mdx removed so this page owns /. - Four live opentui terminal screens (tunnel/proxy/nodes/websocket) embedded as uniform, scroll-free iframes. Stripped the dead React/Tweaks scaffolding that 404'd on tweaks-panel.jsx and loaded React/Babel from unpkg; the vanilla live-sim scripts are unchanged. - Landing-matched dark theme wired into the Starlight docs (src/styles/custom.css), with Space Grotesk + JetBrains Mono loaded via Head.astro. - Conversion-focused section copy; demo acct "bob"; real slug host amber-otter.consensus.canister.software. - Park the fuller LAN-scan "Tunnel Setup" screen in opentui-drafts/ for later. - Stop tracking .claude/ agent worktrees (gitignore + untrack). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…roxy Landing page (src/pages/index.astro): - Networks section: real Ethereum/Solana/ICP logos, Mainnet labels - No-FUD section: pun header, three rewritten tiles (Integration / Configuration / Security), JS+TS runtime strip below the grid - Replace the Run-a-node section with a bottom CTA (spinning logo kept) - Uniform, tighter terminal-to-snippet spacing; WebSocket frame now auto-grows via MutationObserver so all rows stay visible (no scroll) - Responsive pass: stack all grids, wrap hero headline, tighten padding - Mobile nav: hamburger + tap-to-open dropdown menu - Node links repointed to /guides/node/, footer x402 Proxy link removed Docs: remove the x402 Proxy section (sidebar entry + content files). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
… page SEO & indexing: - Add @astrojs/sitemap with weekly changefreq and priority tuning (landing 1.0, node/quickstart funnels 0.9); Starlight's auto-sitemap steps aside once a sitemap integration is present. - Add public/robots.txt (allow all crawlers incl. AI, point to sitemap). - Self-host Space Grotesk + JetBrains Mono as variable woff2 (with OFL licenses); drop Google Fonts from Head.astro, custom.css, and the opentui terminal iframes; preload the woff2 in Head.astro. - Add OG/Twitter cards under public/seo for the landing and node pages. Landing (index.astro): - OG/Twitter/canonical/JSON-LD head block using the SEO card. New /join operator page (src/pages/join.astro): - Standalone page for node providers: hero, four earn streams, vetting/requirements, and the real three-step install flow (git clone -> bun run setup -> pm2), with the setup:wizard alternative. - Requirements presented as a baseline-machine pill strip plus the four admission stress-test gates; de-jargoned copy, no em dashes. - Responsive: grids stack at 860px/560px; long commands scroll in-box. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…scope Brings the docs in line with what is now published on npm (@canister-software/consensus-cli@0.2.0-beta.0) and running on the orchestrator. usage.mdx - mode is documented as "only" | "except", default "except"; both examples that used mode: 'exclusive' now use mode: 'only' - new Route Filtering section with the configurations that are now rejected - new Batch Requests section: options, the settle-everything contract, and the sequential-vs-parallel budget tradeoff (parallel can overshoot limit_usd by up to concurrency-1, and spent_usd reports the real amount) - a caution box for the rename, since the old names are aliased but read backwards concepts.md - the dedupe key is four inputs, not five; the Scope row is gone - inverted the bullet: two callers issuing the same request now share the cache entry, because scope is always global - added a note warning against putting caller-specific values in accept or content-type, which are the only headers the key still covers architecture.md, api.md - x-api-key is documented as deprecated and inert rather than as a routing or deduplication input Safe to publish now: the rename shipped in 0.2.0-beta.0, which is also npm's latest, so `mode: 'only'` behaves as documented rather than silently inverting. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The four opentui pages are iframe embeds on the landing page, not destinations. They are correctly absent from the sitemap, but crawlers follow iframe src, so without a robots directive they can surface as thin standalone results and compete with the real pages. noindex, follow — so the pages stay out of the index while any links they contain still pass through. Co-Authored-By: Claude Opus 5 <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
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.
Readies the docs for launch and indexing. Five commits: three you already pushed (landing page, expanded sections, SEO/fonts/join page) plus two from this session.
Doc accuracy — now safe to publish
0.2.0-beta.0is live on npm and promoted tolatest, so the docs can finally describe the current API. This was blocked until now: on the previously-published build,mode: 'only'didn't error — it fell into the oldinclusivebranch and proxied everything except the listed routes, so publishing these docs earlier would have walked users into a silent routing and billing inversion.usage.mdx—modedocumented as"only" | "except"(default"except"); bothmode: 'exclusive'examples updated; new Route Filtering section covering the now-rejected configurations; new Batch Requests section with the settle-everything contract and the sequential-vs-parallel budget tradeoff (parallel can overshootlimit_usdby up toconcurrency - 1, andspent_usdreports the real amount paid); a caution box for the rename, since the old names are aliased but read backwards.concepts.md— the dedupe key is four inputs, not five; the Scope row is gone. The bullet is inverted: two callers issuing the same request now share the cache entry, because scope is always global. Added a warning against putting caller-specific values inaccept/content-type, the only headers the key still covers.architecture.md,api.md—x-api-keydocumented as deprecated and inert.SEO fix
The four
opentui/*.htmlpages are iframe embeds on the landing page, not destinations. They're correctly absent from the sitemap, but crawlers followiframe src, so with no robots directive they could surface as thin standalone results competing with the real pages. Addednoindex, follow— out of the index, links still pass through.Verified
index.htmlpages — exact match,404.htmlcorrectly excludedrobots.txtallows all crawlers and points atsitemap-index.xmlmain🤖 Generated with Claude Code