playbook/antigravity-awesome-skills/skills/docs-as-marketing/README.md

docs-as-marketing

Transform documentation into a powerful marketing channel that attracts, converts, and retains developers.

What This Skill Covers

• Information Architecture: Structuring docs for discoverability and conversion
• Quickstart Optimization: Getting developers to success in under 5 minutes
• API Reference Best Practices: Copy-paste code that actually works
• Search Optimization: Making docs rank for developer queries
• Measuring Effectiveness: Metrics that matter for docs-led growth

When to Use This Skill

• Planning or restructuring developer documentation
• Optimizing quickstart flows for better conversion
• Improving API reference usability
• Building docs as a developer acquisition channel
• Reducing support tickets through better self-service

Key Principle

Great documentation is invisible marketing. It reduces friction, builds trust, and turns visitors into advocates—all while helping developers succeed.

Quick Wins

1. Ensure your quickstart delivers success in under 5 minutes
2. Add copy-paste code examples to every API endpoint
3. Include "What's Next" links on every page
4. Test that all code examples actually run
5. Add "Was this helpful?" feedback to measure quality

Related Skills

• api-onboarding - Reducing time-to-first-API-call
• sdk-dx - SDK design that simplifies documentation
• developer-sandbox - Interactive playground environments