Repository navigation
feat(docs): Workspaces guide, workspace pricing and acceptable use policy - #153
Merged
Merged
Conversation
…licy Workspaces open to every paying member. This adds the member-facing documentation and the commercial and legal surfaces for the launch. - Docs: new /docs/workspaces (EN + ES) in Guides (order 18; examples and apps move to 19/20 to keep orders gapless). Covers who can get one, sizes and prices, create, connect (SSH command, SSH keys tab, Console web terminal), agents and the Software panel, backups and restore, network rules, lifecycle/grace/deletion and FAQ. Linked from the docs introduction. - /docs/agents (retired v1) now 301s to /docs/workspaces instead of the docs root; the empty-target branch of the redirect is removed. - Pricing: workspace slots + backup add-on table under the tiers, premium lists its free Micro workspace, new FAQ entry. The community "not included" item no longer says workspaces are unavailable. - Terms (EN + ES): "Workspace acceptable use" section (dated October 6, 2026), page date updated. Tests: workspacesDocs (catalogue table in docs and pricing agree, facts, anchors, links, intro link, redirect targets live), workspaceAcceptableUse (every prohibition, tunnels, no refund, deletion incl. backups, date), pricing additions, middleware. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Since cloud-api migration 097 a workspace's SSH keys are a list managed in the portal (SSH keys tab, up to 10) that the SSH gateway checks; they are not stored on the workspace disk. A restore rewrites the disk only, so it neither brings back nor drops a managed key. Replace the stale "only your current NaN SSH key is re-applied" (EN + ES) and say the same in the Workspaces guide's backup section. Tests pin the new wording and the absence of the old one. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Replace the short "Create a workspace" steps (EN + ES) with a step-by- step "Create your workspace" that follows the four wizard steps: slot or included free workspace, name rules and where to get the SSH public key (cat / ssh-keygen -t ed25519), agent selection (changeable later from the Software panel), Hermes (model, Telegram token from @Botfather, soul) and Pi (name, model, gentle-shell) config, then review and create. Three screenshots in public/docs/workspaces/*.webp (~40-50 KB each). The owner's real SSH public key in step 1 is replaced by a fake example key rendered in the same font, and the helper text no longer says "VM". A new <Screenshot> docs component renders a lazy, sized figure with a caption; mdxToText serves it as a markdown image plus italic caption (fixture added), so /api/docs keeps working. Tests: screenshots exist, WebP size matches the declared width/height, alt and caption present and translated, no internal terms, the wizard facts are stated, only the published files live in the folder. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…h Herdr New section (EN + ES) right after "Create your workspace": install an SSH app (Termius), generate a key, add the public key in the SSH keys tab, create a host (ssh.nan.builders, port 30222, username = the part before @ in the SSH command, the generated key, SSH on / Mosh off), connect, and run agents inside Herdr so they keep running and the same session can be reattached from any device. Herdr tips come from the base image notes (run herdr to start or reattach; plain SSH, not Mosh; ED25519/RSA/ECDSA P-256 keys accepted). Nine screenshots in public/docs/workspaces/phone-*.webp, half resolution (645 px wide for phone screens). Private data replaced before export: key name, workspace id in the SSH command, key fingerprint, host subtitle id, Termius username, the workspace's private IPs and hostname in the terminal. <Screenshot variant="phone"> shows phone screens narrower. The docs' SSH command now includes the gateway port (-p 30222), as the dashboard shows it. Tests: every screenshot exists in order with size, alt and caption, phone variant on phone screens, no UUIDs / 10.x addresses / ws-<hex> hostnames in names, alt, captions or copy, placement after the create section, connection details and Herdr basics, SSH command with port. Co-Authored-By: Claude Opus 5.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
2 participants
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.
What
Website changes for opening Workspaces to every paying member.
/docs/workspaces+/es/docs/workspaces(Guides, order 18; examples/apps renumbered 19/20, gapless): what it is, who can get one, sizes and prices, create, connect (SSH command from the dashboard, SSH keys tab, Console web terminal), agents and the Software panel, backups/restore, network rules, lifecycle (grace, rescue session, deletion), FAQ. Linked from the docs introduction./docs/agentsnow 301s to/docs/workspaces(was the docs root). The middleware note about Workspaces having no docs page is gone, and so is the now-unused empty-target branch.#workspaces), premium tier lists "one free Micro workspace", new FAQ entry. The unrendered community "not included" item no longer says workspaces are unavailable.#workspace-acceptable-usesection, dated October 6, 2026 (crypto mining, scanning/attacks incl. our infra, DDoS, spam/phishing/malware, open proxies/VPN/Tor exit or relay, credential stuffing, illegal content, reselling compute; reverse tunnels only for own access/dev; SMTP blocked; suspension/deletion without notice, no refund on abuse, cooperation with abuse reports; deletion includes backups).No internal technology named in member-facing copy (
noInfraDisclosurecovers the new pages).Facts and sources
internal/workspace/tiers.go(micro/free 1/2/10, nano 2/4/20, basic 4/8/40, medium 8/16/80, large 8/32/160).cmd/stripe-bootstrap/workspace_backups.go(0,99 / 1,49 / 2,49 / 3,99 / 6,99). Slot prices (4,99 / 8,99 / 16,99 / 32,99 / 60,99) are Stripe-only, taken from the launch brief.revoke.DefaultSlotGrace, also for payment failure); same-size re-purchase keeps the data; micro slot adopts a lapsed free workspace; rescue 2h x 3/day; egress 22/80/443 only (nan-vmdDefaultEgressTCPPorts), per-VM new-connection and outbound-SSH rate limits.origin/mainstill grants it to any inference-entitled member (InferenceEntitled, so 70€ too). This PR should merge together with, or after, the cloud-api change that restricts it.Tests
src/tests/layouts/workspacesDocs.test.ts: the docs table and the pricing table agree with the catalogue, the premium-only free workspace, no inference in slots, connect/software/network/backups/lifecycle facts, terms anchors exist, internal links resolve, intro links the page, everyREMOVED_DOCStarget is live in both locales.src/tests/legal/workspaceAcceptableUse.test.ts.pricing.test.tsandmiddleware.test.tsupdated.npm run buildOK,astro check0 errors. Full vitest: 1459/1460 passed; the one failure (and a worker-start error) were 5s timeouts while the machine was asleep. Re-ran those files plus every affected suite: 278/278 passed.🤖 Generated with Claude Code