docs: weekly improvements (2026-02-01)docs: weekly improvements (2026-02-01)

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: <description>`
+
+---
+
+## 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.

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.
 
+<Tip>
+**Time to first call:** ~3 minutes with USDC ready, ~10 minutes including devnet setup.
+</Tip>
+
 ## Prerequisites
 
 - A Solana wallet with USDC (devnet for testing)

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
+
+<AccordionGroup>
+  <Accordion title="Do I need to create an account?">
+    No. ASG Agent Cloud is **permissionless**. Connect your wallet and start using services immediately.
+  </Accordion>
+  <Accordion title="What currencies are supported?">
+    Currently **USDC on Solana**. We cover all transaction fees (gasless).
+  </Accordion>
+  <Accordion title="Is there a free tier?">
+    Devnet is free for testing. On mainnet, you pay only for what you use with no minimums.
+  </Accordion>
+  <Accordion title="Can humans use ASG, or only AI agents?">
+    Both! While optimized for agents, the API works for any client that speaks MCP or REST.
+  </Accordion>
+</AccordionGroup>
+
 <Card
   title="Security"
   icon="shield"