From 3a25d7e9e8ea57dbb95f68df0277da49fafcc5e1 Mon Sep 17 00:00:00 2001 From: Aidar Date: Sun, 1 Feb 2026 11:05:10 -0700 Subject: [PATCH] docs: weekly improvements (2026-02-01) - Add FAQ accordion on intro page (common questions) - Add 'time to first call' tip on quickstart - Add DOCS_GOVERNANCE.md (ownership + weekly routine) --- DOCS_GOVERNANCE.md | 78 ++++++++++++++++++++++++++++++++++++++++++++ guide/quickstart.mdx | 4 +++ introduction.mdx | 17 ++++++++++ 3 files changed, 99 insertions(+) create mode 100644 DOCS_GOVERNANCE.md diff --git a/DOCS_GOVERNANCE.md b/DOCS_GOVERNANCE.md new file mode 100644 index 0000000..bf25bf1 --- /dev/null +++ b/DOCS_GOVERNANCE.md @@ -0,0 +1,78 @@ +# Documentation Governance + +> **Owner:** CTO / Engineering Lead +> **Last Updated:** 2026-02-01 + +## Ownership + +| Path | Owner | Reviewers | +|------|-------|-----------| +| `openapi/*` | @security @cto | Required | +| `security/*` | @security | Required | +| `billing/*` | @cto @finance | Required | +| `*` | @docs-team | Optional | + +See [CODEOWNERS](.github/CODEOWNERS) for enforcement. + +--- + +## Weekly Improvement Routine + +**Cadence:** Every week, 20 minutes + +1. **5 min** — Review analytics: top searches + zero-result queries +2. **10 min** — Pick 3 quick fixes: + - Add FAQ block + - Add code example + - Add "next steps" link +3. **5 min** — Create PR, run CI, merge + +**PR naming:** `docs: weekly improvements (YYYY-MM-DD)` + +--- + +## OpenAPI Updates + +Single source of truth: [`openapi/public.openapi.yaml`](openapi/public.openapi.yaml) + +**Update process:** + +1. Edit OpenAPI spec +2. Run `npm run validate:openapi` +3. Update changelog: `guide/changelog.mdx` +4. PR with prefix: `api: ` + +--- + +## Error Code Updates + +All public error codes in [`resources/errors.mdx`](resources/errors.mdx). + +**When adding new errors:** + +1. Add to gateway error handler +2. Add to docs with description + resolution +3. Ensure code examples show error handling + +--- + +## Incident Response + +See [SECURITY.md](SECURITY.md) for vulnerability disclosure. + +**Docs incident process:** + +1. Identify leaked content in [#docs-alerts] +2. Immediate: revert PR or emergency commit +3. Post-incident: update banlist `.leak-banlist.txt` + +--- + +## Partner Portal Access + +Partner docs require NDA. Access managed via: + +- **MVP:** Password protection per partner +- **Target:** SSO via IdP with `partners` group + +Audit: All access logged at CDN level. diff --git a/guide/quickstart.mdx b/guide/quickstart.mdx index 7850bd9..0e34047 100644 --- a/guide/quickstart.mdx +++ b/guide/quickstart.mdx @@ -7,6 +7,10 @@ description: "Call your first ASG tool in under 5 minutes" Get started with ASG Agent Cloud in just a few steps. No registration required. + +**Time to first call:** ~3 minutes with USDC ready, ~10 minutes including devnet setup. + + ## Prerequisites - A Solana wallet with USDC (devnet for testing) diff --git a/introduction.mdx b/introduction.mdx index 80957e6..74f8411 100644 --- a/introduction.mdx +++ b/introduction.mdx @@ -70,6 +70,23 @@ ASG Agent Cloud is **infrastructure designed for AI agents**. Unlike traditional ASG Agent Cloud is the foundation for the next generation of autonomous AI applications. Built on Solana for instant, low-cost payments and designed from the ground up for agent-to-agent commerce. +## Frequently Asked Questions + + + + No. ASG Agent Cloud is **permissionless**. Connect your wallet and start using services immediately. + + + Currently **USDC on Solana**. We cover all transaction fees (gasless). + + + Devnet is free for testing. On mainnet, you pay only for what you use with no minimums. + + + Both! While optimized for agents, the API works for any client that speaks MCP or REST. + + +