Skip to content

CON-1584: Surface host account and CLI/API/SDK docs#2

Draft
jjziets wants to merge 30 commits into
CON-1581-host-teams-on-pr153from
CON-1584-host-cli-api-sdk
Draft

CON-1584: Surface host account and CLI/API/SDK docs#2
jjziets wants to merge 30 commits into
CON-1581-host-teams-on-pr153from
CON-1584-host-cli-api-sdk

Conversation

@jjziets

@jjziets jjziets commented Jul 8, 2026

Copy link
Copy Markdown
Owner

Summary

  • add a Host Account sidebar group with Host Agreement and Security pages
  • add a Host Host Account Security bridge page that surfaces 2FA, API Keys, and Teams from the Host section without duplicating the canonical general docs
  • add a Host CLI/API/SDK intro page that orients hosts to the existing Host CLI and SDK reference pages and links to canonical CLI, SDK, and API setup/rate-limit docs
  • add contextual links from Host overview, quickstart, account/agreement, self-test, fleet operations, and Common Host Questions pages
  • add safe host setup/navigation screenshots for finding the setup flow and Machines link
  • order Host > Verify & List around the host lifecycle: optimize, self-test/reference, pricing/market metrics, verification, then search troubleshooting

Stacking

Validation

  • git diff --check
  • python3 -c JSON parse check for docs.json
  • npx --yes mint@4.2.647 validate — success
  • local preview routes returned 200 for /host/account-security-for-hosts, /host/account-hosting-agreement, /host/cli-api-sdk, /host/how-to-self-test, /host/self-test-reference, /host/common-host-questions, /host/not-in-search, /host/installing-host-software, and the affected Verify & List routes
  • graphify update . — updated local monorepo graph; latest run rebuilt graphify-out after the docs/image change

Open Notes

  • CON-1581 owns the dedicated Host Teams page. This PR links to the canonical Teams Quickstart for now so it can remain independently reviewable on top of PR CON-1518/CON-1077: Host docs IA + headless handover vast-ai/docs#153.
  • After CON-1581 lands, we should decide whether Host Account Security should also link to /host/host-teams.
  • Additional host-dashboard screenshots would be useful once a test/real host machine is available on the account: Machines health/status, self-test state, pricing/listing controls, and Host Market metrics.

guthrie-vast and others added 17 commits June 22, 2026 19:05
Replace source-install steps with marketplace commands for the Claude
Code, Codex, and Cursor plugins.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…lace-install

docs(agents): use marketplace install flow for agent plugins
…I content

- Remove host content from the renter notifications guide and account settings
- Add host/notifications page for host machine, verification, and maintenance events
- Add shared notification-channels snippet used by both renter and host pages
- Reference the Notifications API from the webhooks guide instead of inlining curl/JSON
- Drop the duplicate top-level Notifications API nav group (now only under Endpoints)
- Harmonize signature-verification code and fix wording/naming consistency

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Adding New Notifications Documentation with Webhook workflow examples
Explains that cancelling early claws back the discount received plus
a 5% fee, and corrects the worked example's math to match.
…example

Docs/reserved refund fee example
@jjziets
jjziets force-pushed the CON-1584-host-cli-api-sdk branch from d8f4dec to 0d129d0 Compare July 9, 2026 14:29
@jjziets
jjziets changed the base branch from CON-1077-headless-hosting-guide to CON-1581-host-teams-on-pr153 July 9, 2026 14:29
Hannes Zietsman and others added 10 commits July 10, 2026 11:35
Reviewers run 'node review-server.mjs' next to 'npm run dev' and browse
http://localhost:4000 to comment directly on pages; feedback exports as
Jira-importable CSV/Markdown/JSON. To be dropped before merge.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…seams

- self-test-reference: anchors for every quick-table error family
  (reliability, auth-error, direct-ports, bandwidth, insufficient-resources,
  system-requirements) so CLI errors and support replies can deep-link
- how-to-self-test: fix 7 GiB -> 7 GB drift (CLI gate is decimal GB,
  vast.py:9549) and defer to verification-stages as the canonical gate list
- machine-errors: mark self-test-reference as canonical for nccl_failed and
  machine-not-rentable to remove duplicate retrieval targets
- installing-host-software: anchored identify-4xx section with the concrete
  root causes (fresh-key guidance per Hanran's 2026-06-16 corrections)
- hosting-overview <-> quickstart now cross-linked; quickstart gains the
  Earn step; account page sidebar renamed Account & Agreement to stop
  colliding with Reference's Hosting Agreement
- merge main: slot host/notifications into Operate with persona chips;
  reorder Verify & List so optimization-guide follows listing tasks

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…eference

- common-errors-diagnostics: the six stacked legacy anchors now land on a
  routing list that jumps to the canonical machine-errors entries
- CLI self-test snippet: link failures to Self-Test Reference / Machine
  Error Reference, closing the CLI-docs side of the deep-link loop

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
scripts/check_persona_chips.py verifies that personas: frontmatter and the
visible persona-chips div stay in sync on every authored host page
(slug->label mapping, all-four collapse to 'All host personas', order-free
membership; generated cli/sdk pages exempt). Run with:

  npm run check-persona-chips

Closes the last accepted-risk item from the CON-1518 IA audit.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
REVIEW-QUESTIONS.md (GitHub-linkable, commentable in the PR diff) and a
hidden /review-questions preview page (annotatable via the review kit,
answers land in the same feedback export). Both temporary review aids,
removed before merge. Reviewers previously had no pointer from the
roadmap's '8 inputs' to the actual questions.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The overlay panel footer and the /__review__/ status page now point to
/review-questions so reviewers discover the questions inside the kit,
not only via the PR description or roadmap.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants