2. 1. The technical writing market
Key numbers
| Professional technical writers (worldwide) | ~100,000 |
|---|---|
| People who write docs as part of their job (devs, PMs, DevRel) | ~200,000-500,000 |
| Companies with dedicated doc teams (3+ writers) | ~8,000-12,000 |
| Freelance technical writers | ~15,000-25,000 |
| API documentation projects active globally | ~500,000+ |
| Global docs tools market | ~$1-2 billion/year |
| Growth rate | ~12-15%/year |
| Average budget per doc team (enterprise) | $2,000-15,000/month |
| Average budget per freelancer | $50-300/month |
| Average technical writer salary (US) | $75,000-110,000/year |
| Average technical writer salary (EU) | $45,000-75,000/year |
Types of technical writing
| Type | % of market | Tools used | Key pain |
|---|---|---|---|
| Software/API documentation | ~40% | GitBook, ReadMe, Docusaurus, MkDocs, Mintlify | Keeping docs in sync with code, versioning, API reference generation |
| Product documentation (SaaS/apps) | ~25% | GitBook, Notion, Confluence, Zendesk Guide | Screenshots that go stale, multi-product docs, search quality |
| Enterprise/regulated docs (medical, aerospace, finance) | ~15% | MadCap Flare, Adobe FrameMaker, Paligo, DITA CMS | Compliance, structured authoring, translation, review workflows |
| Internal documentation (knowledge bases, wikis) | ~10% | Confluence, Notion, Slite, Guru | Stale content, discoverability, no ownership |
| Developer experience / DevRel docs | ~10% | Mintlify, ReadMe, custom-built | Interactive examples, onboarding flows, analytics |
Why it's interesting
- AI is reshaping everything: LLMs can draft, review, and translate docs, but no tool does it well natively yet
- Docs-as-code is mainstream: Markdown + Git is the standard for software docs, but the tools are still primitive
- Enterprise budgets are large: doc teams at big companies spend $5,000-15,000/month on tools
- High retention: once a team adopts a docs tool, they rarely switch (migration is painful)
- The incumbents are complacent: MadCap Flare hasn't innovated in years, Confluence is hated, GitBook is limited
- "Docs are the product": more companies realize that documentation quality directly impacts adoption, support costs, and churn
Why it's hard
- Migration is brutal: moving 500 pages of docs to a new tool is a multi-week project
- Enterprise sales cycles are long: 3-6 months for a doc team decision
- Writers are picky: they care deeply about editing experience, and a mediocre editor is a dealbreaker
- Build vs. buy: many dev teams build their own docs site with Docusaurus/MkDocs and won't pay for a hosted tool
- Free/open source competition: Docusaurus, MkDocs, Sphinx are free and good enough for many
3. 2. Complete map of existing tools
Developer documentation platforms
| Tool | Price | Customers | Strengths | Weaknesses |
|---|---|---|---|---|
| GitBook | Free to $299/mo | ~50,000 orgs | Beautiful output, Git sync, easy to use, good free tier | Limited customization, no API reference generation, editor can be slow, search is basic |
| ReadMe | $99-399/mo | ~5,000 companies | API reference from OpenAPI, interactive "Try It", metrics, developer hub | Expensive, opinionated design, hard to customize, editor is mediocre |
| Mintlify | Free to $500/mo | ~3,000 companies | Beautiful, fast, MDX-based, AI search, great DX | Young, limited enterprise features, Markdown-only (no visual editor for non-devs) |
| Docusaurus (Meta) | Free (open source) | ~30,000 sites | Free, React-based, huge ecosystem, versioning, i18n | Requires dev to set up, no visual editor, no analytics, no collaboration |
| MkDocs / Material for MkDocs | Free (sponsorware for Insiders) | ~20,000 sites | Free, Python-based, beautiful Material theme, search, plugins | Requires dev, Python ecosystem, no visual editor, no collaboration |
| Sphinx | Free (open source) | ~15,000 sites | Industry standard for Python docs, reStructuredText, extensible | Ancient UX, steep learning curve, ugly default theme, slow builds |
| Nextra | Free (open source) | ~5,000 sites | Next.js-based, fast, MDX, modern | Less mature, smaller ecosystem |
Enterprise / structured authoring
| Tool | Price | Strengths | Weaknesses |
|---|---|---|---|
| MadCap Flare | $182/mo per user | Multi-channel publishing (HTML, PDF, ePub), conditional content, variables, snippets, industry standard for 15+ years | Windows-only, ancient UI, steep learning curve, expensive, no cloud-native option |
| Adobe FrameMaker | $29.99/mo | Long documents (1000+ pages), DITA support, structured authoring | Legacy, complex, Windows-only, declining user base |
| Paligo | ~$300-1,000/mo | Cloud-native CCMS, structured authoring, component reuse, translation management | Expensive, complex, learning curve, DITA-oriented |
| Author-it | Enterprise pricing | Component content management, multi-channel | Dated, expensive, enterprise-only |
| Heretto (formerly easyDITA) | Enterprise pricing | Cloud DITA CMS, review workflows, publishing | DITA-only, enterprise pricing |
Knowledge bases / help centers
| Tool | Price | Strengths | Weaknesses |
|---|---|---|---|
| Confluence (Atlassian) | Free to $6/user/mo | Ubiquitous, Jira integration, cheap | Terrible editor, slow, ugly output, poor search, "where docs go to die" |
| Notion | Free to $18/user/mo | Beautiful editor, flexible, popular | Not built for docs (no versioning, no publishing pipeline, SEO issues) |
| Zendesk Guide | Bundled with Zendesk ($55+/agent/mo) | Integrated with support tickets, customer-facing | Limited editor, tied to Zendesk ecosystem, basic |
| Document360 | $199-599/mo | Purpose-built knowledge base, versioning, analytics, AI | Expensive, UI not as polished as GitBook |
| HelpDocs | $69-399/mo | Simple, clean, fast, good for small teams | Limited features, no dev docs features |
API documentation specific
| Tool | Price | Strengths | Weaknesses |
|---|---|---|---|
| Swagger UI / Redoc (OpenAPI) | Free | Standard, auto-generated from OpenAPI spec | Ugly (Swagger), limited customization, no guides/tutorials alongside |
| Stoplight | Free to $399/mo | API design + docs, visual OpenAPI editor, style guides | Focused on API design not general docs, complex |
| Scalar | Free (open source) to $149/mo | Beautiful API reference from OpenAPI, modern, fast, open source core | API reference only, no guides/tutorials |
| Bump.sh | Free to $149/mo | API docs + changelog from OpenAPI/AsyncAPI, diff detection | Niche, limited to API reference |
What's MISSING in the market
- No tool combines guides + API reference + changelog natively: you need GitBook + Scalar + Headway = 3 tools
- No AI-native docs tool: AI that drafts docs from code, reviews for accuracy, keeps docs in sync with code changes, translates
- No modern replacement for MadCap Flare: cloud-native, multi-channel, structured authoring without the 2005 UI
- No docs analytics that matter: which pages reduce support tickets? Which docs have the highest bounce? Which are stale?
- No "docs freshness" tool: automatically detect when docs are outdated based on code changes, product updates, or age
- No collaborative review workflow that works: Google Docs-style commenting + approval + publishing pipeline for docs
- No visual editor for docs-as-code: write in Markdown/MDX with Git sync BUT with a Notion-like visual editor for non-devs
- No "docs health" dashboard: coverage, freshness, search analytics, support ticket correlation in one view
4. 3. The technical writer's workflow: where the pain is
The documentation lifecycle
| Stage | Time | Tools used | Pain | Opportunity |
|---|---|---|---|---|
| 1. Research / understand the feature | 2-4h/doc | Jira, Slack, meetings with devs, reading code | Devs don't explain things well, specs are incomplete | AI that reads PRs/commits and generates draft docs |
| 2. Write the draft | 2-8h/doc | GitBook, Notion, VS Code, Google Docs | Starting from blank page, consistency, following style guide | AI drafting, templates, style guide enforcement |
| 3. Add screenshots / visuals | 1-3h/doc | Snagit, CleanShot, browser, Figma | Screenshots go stale within weeks, manual process | Automated screenshot capture + staleness detection |
| 4. Review (SME + editorial) | 1-5 days (waiting) | Google Docs comments, PR reviews, email, Slack | Review is the biggest bottleneck, devs don't review docs | In-context review workflow with nudges and approvals |
| 5. Publish | 15min-1h | CI/CD, manual deploy, CMS publish button | Docs-as-code = need a dev to deploy. CMS = publish button but less control. | One-click publish with preview + rollback |
| 6. Maintain / update | Ongoing (20-40% of time) | Git blame, changelog, Slack alerts, gut feeling | Nobody knows which docs are stale until a user complains | Staleness detection: code changed? Feature updated? Flag the doc. |
| 7. Measure impact | Rarely done | Google Analytics (maybe) | Can't prove docs reduce support tickets or improve onboarding | Docs analytics: page views, feedback, support ticket correlation |
5. 4. Real pains (by role and team size)
Solo technical writer / freelancer
| Pain | Severity | Opportunity |
|---|---|---|
| "I spend 30% of my time updating stale docs" | 5/5 | AI staleness detection: monitor code repos, product changes, flag outdated pages |
| "I can't get devs to review my docs" | 5/5 | Review workflow with Slack nudges, approval tracking, "review takes 5 min" UX |
| "I write the same type of doc over and over (API endpoint, how-to, tutorial)" | 4/5 | Smart templates + AI drafting from code/specs |
| "I can't prove the value of docs to leadership" | 4/5 | Analytics dashboard: support ticket deflection, onboarding completion, search queries |
| "Screenshots are the worst part of my job" | 4/5 | Automated screenshot capture from URLs, staleness alerts |
Doc team (3-10 writers)
| Pain | Severity | Opportunity |
|---|---|---|
| "We have no idea which docs are stale or missing" | 5/5 | Docs coverage + freshness dashboard |
| "Our style guide exists but nobody follows it" | 4/5 | Style guide linting (like Vale but integrated, not CLI-only) |
| "We need to publish to multiple outputs (web, PDF, in-app)" | 4/5 | Multi-channel publishing from one source |
| "Localization is a nightmare (30+ languages)" | 5/5 | AI translation + translation memory + i18n workflow |
| "We can't track who changed what and why" | 3/5 | Full audit trail, version history, blame view |
| "Our docs tool doesn't integrate with our ticketing system" | 3/5 | Jira/Linear/GitHub Issues integration (link docs to features) |
Developer writing docs (not a writer)
| Pain | Severity | Opportunity |
|---|---|---|
| "I hate writing docs, I'd rather code" | 5/5 | AI that generates docs from code (docstrings, PR descriptions, commit messages) |
| "The docs tool is too complex, I just want to write Markdown" | 4/5 | Markdown-native with zero config, Git sync, just works |
| "I forget to update docs when I change the code" | 5/5 | CI check: "this PR changes code in X module, docs for X haven't been updated" |
| "I don't know what the current docs say" | 3/5 | AI search over your own docs, "what do our docs say about X?" |
6. 5. Segments to target
| Segment | Market size | Competition | Avg ticket | Recommendation |
|---|---|---|---|---|
| AI-native docs platform (guides + API ref + AI) | ~30,000 dev teams | Medium (GitBook, Mintlify lack AI depth) | $99-499/mo | ★★★★ Ambitious but differentiated |
| Docs freshness / staleness detection | ~20,000 teams with docs | None (nobody does this well) | $49-199/mo | ★★★★★ Best entry point |
| AI doc writer (generate docs from code) | ~100,000 dev teams | Emerging (Mintlify has basic, Copilot does inline) | $29-99/mo | ★★★★ Strong demand, hard to nail quality |
| Docs analytics + health dashboard | ~10,000 doc teams | Very low | $49-199/mo | ★★★★ "Prove docs value" is a hot topic |
| Modern MadCap Flare replacement (cloud, multi-channel) | ~5,000 enterprise doc teams | Low (Paligo is the only real one) | $500-3,000/mo | ★★★ Big ticket but long sales cycle |
| Visual editor for docs-as-code (Notion-like + Git) | ~20,000 teams | Low (GitBook is closest but not true Git-native) | $49-199/mo | ★★★★ Strong differentiator |
| Automated screenshot tool for docs | ~15,000 writers | Very low (Screenly, manual process) | $19-49/mo | ★★★ Small niche but real pain |
7. 6. Buyer profiles and design partners
Who buys?
| Profile | Why they buy | Signal | Where to find | DP score |
|---|---|---|---|---|
| Solo tech writer at a startup (50-200 employees) | Overwhelmed, needs to be 3x more productive | "I'm the only tech writer, I can't keep up" | Write the Docs Slack, LinkedIn, Twitter/X | ★★★★★ |
| DevRel / Developer Advocate | Docs are part of DX, wants best-in-class dev docs | Active on Twitter, speaks at conferences, cares about DX | Twitter/X, dev conferences, DevRel communities | ★★★★★ |
| Head of Docs / Doc team lead | Needs to prove team value, scale output, reduce tool sprawl | "We're evaluating docs tools", LinkedIn posts about docs strategy | LinkedIn, Write the Docs conferences | ★★★★ |
| Founding engineer who does everything | Needs docs but doesn't want to spend time on them | "Our docs suck", "I hate writing docs" | Twitter/X, Hacker News, Indie Hackers | ★★★★ |
| Freelance tech writer | Needs tools that work across multiple clients | Active in Write the Docs, freelance writer communities | Write the Docs Slack, Upwork, LinkedIn | ★★★ (low budget but great feedback) |
Best design partner characteristics
- Owns docs at a 50-500 person tech company (enough docs to have real pain, small enough to decide fast)
- Currently frustrated with their tool (migrating or considering migration)
- Active in the community (Write the Docs, Twitter, conference speaker)
- Using docs-as-code already (Markdown + Git = aligned with modern approach)
- Has API documentation (higher complexity = more value from a good tool)
8. 7. How to reach them (scripts included)
Channel #1: Write the Docs community (the best)
Write the Docs is THE community for technical writers. 15,000+ members across Slack, conferences, and meetups. This is where your first 10 customers will come from.
- Write the Docs Slack: join and participate in #general, #career-advice, #tooling channels
- Write the Docs conferences: Portland (May), Prague (September), Australia (December)
- Write the Docs meetups: monthly in 30+ cities worldwide
Strategy: don't sell. Participate, help, share insights. Post a question: "What's your biggest frustration with your current docs tool?" Listen. Build relationships. Then DM the people who resonated.
Channel #2: Twitter/X
Search for:
- "docs are outdated", "stale documentation", "docs drift"
- "hate writing docs", "docs suck", "documentation is broken"
- "looking for a docs tool", "migrating from Confluence", "GitBook alternative"
- "technical writer" + frustration keywords
DM script:
Hey [name]! I saw your tweet about [specific docs frustration]. I'm a developer building a tool specifically for [that problem]. Quick question: what's the #1 thing that would save you the most time in your docs workflow?
Channel #3: LinkedIn
Search for "Technical Writer", "Documentation Manager", "Developer Relations" + company size 50-500.
LinkedIn message:
Hi [name], I noticed you're leading docs at [company]. I'm researching the biggest pain points for doc teams right now. What's the one thing your current docs tool doesn't do well enough? I'm building something to fix that and would love 15 min of your time. No pitch, just learning.
Channel #4: Hacker News / Reddit
- Post a "Show HN" when you have an MVP
- Comment on docs-related threads (there's one every week)
- r/technicalwriting (~40K members)
- r/programming when docs tools come up
Volume
| Step | Volume | Rate | Result |
|---|---|---|---|
| DMs / emails sent | 80 | 25-35% response | 20-28 conversations |
| Conversations | 24 | 40% take a call | 10 calls |
| Calls | 10 | 30% become DP | 3 design partners |
Tech writers are excellent respondents: they're communicators by trade, they care about tools, and they love giving structured feedback.
9. 8. Disruption strategies
Strategy A: "The docs freshness engine" (recommended #1)
Principle: a tool that monitors your docs and tells you what's stale, what's missing, and what needs updating. The "tech debt tracker" for documentation.
| Feature | Priority | Dev time |
|---|---|---|
| Connect to docs source (GitBook, GitHub repo, Confluence, any URL) | P0 | 3 days |
| Connect to code repo (GitHub/GitLab): detect code changes in documented areas | P0 | 3 days |
| Freshness score per page (age, related code changes, user feedback) | P0 | 2 days |
| Dashboard: all docs sorted by staleness risk, coverage gaps, missing pages | P0 | 3 days |
| Alerts: Slack/email when a doc becomes stale (code changed, page too old) | P1 | 2 days |
| AI review: "this doc mentions feature X, but the code for X changed in PR #456" | P1 | 3 days |
| Style guide checking (Vale integration or custom rules) | P2 | 2 days |
| Docs health score (single number: 0-100 for your entire docs site) | P2 | 1 day |
| CI integration: block PRs that change code without updating docs | P2 | 2 days |
Why this is the best entry point:
- Nobody does this: zero competitors for "docs freshness as a service"
- Works with any docs tool: doesn't require migration. Plugs into GitBook, Docusaurus, Confluence, anything.
- Pain is universal: every doc team struggles with stale docs
- Measurable ROI: "before: 40% of docs were stale. After: 5%"
- Trojan horse: once you're monitoring docs, you can expand to editing, publishing, analytics
- AI-native: LLMs are perfect for "read this doc, read this PR, are they still in sync?"
Strategy B: "AI docs writer from code"
Principle: connect to a code repo, the AI reads the code and generates documentation automatically. The "Copilot for docs".
- Read function signatures, docstrings, types, and generate API reference
- Read PR descriptions and generate changelog entries
- Read code changes and suggest doc updates
- Generate tutorials from test files (tests show how to use the code)
- Draft "getting started" guides from README + code structure
Risk: quality. AI-generated docs that are wrong are worse than no docs. Need human-in-the-loop.
Strategy C: "The visual editor for docs-as-code"
Principle: a Notion-like editor that writes to Markdown files in a Git repo. Best of both worlds: non-dev-friendly editing + developer-friendly source control.
- WYSIWYG editor that reads/writes Markdown/MDX
- Git sync (every save = commit, PRs for review, branches for drafts)
- Built-in components (callouts, tabs, code blocks, API playground)
- Invite non-dev contributors without teaching them Git
- Preview + publish pipeline
This is essentially "GitBook done right". GitBook has Git sync but the editor is mediocre and the sync is flaky.
Strategy D: "Docs analytics that prove ROI"
Principle: analytics for documentation that go beyond page views. Correlate docs usage with support tickets, onboarding success, and product adoption.
- Page views, time on page, scroll depth, search queries with no results
- "Was this helpful?" feedback widget with aggregation
- Correlation: "users who read the Setup Guide have 3x lower support ticket rate"
- Coverage report: "these features have no documentation"
- Stale docs report (by age, by last edit, by user feedback score)
10. 9. Pricing
Context
- Doc teams have budget but it's usually owned by Engineering or Product, not the writer
- The buyer is often the Head of Docs, VP Engineering, or CTO
- Freemium works well for individual writers, but enterprise needs a sales conversation
- Per-seat pricing is accepted in this market (GitBook, Confluence do it)
- Usage-based (per page, per project) also works well
Pricing: Docs freshness engine
| Plan | Price | Includes | Target |
|---|---|---|---|
| Free | $0 | 1 docs site, 50 pages, freshness dashboard, basic alerts | Solo writers, small projects |
| Pro | $49/mo | Unlimited pages, 3 code repos, AI review, style checking, Slack alerts | Startups, small doc teams |
| Team | $149/mo | Pro + unlimited repos, CI integration, health score, multiple doc sites, API | Mid-size companies |
| Enterprise | $499/mo+ | Team + SSO, audit log, SLA, dedicated support, custom integrations | Large doc teams |
Design partner
- 3 months free (Pro plan) in exchange for weekly feedback (30 min/week)
- Then 50% off for life
- Max 5 design partners (tech writers give excellent feedback, take more)
- Bonus: if they write a blog post or speak about the tool at Write the Docs, free for an extra year
11. 10. Day-by-day action plan (D1 to D30)
Week 1: Research and first contacts (D1-D7)
| Day | Actions | Deliverable |
|---|---|---|
| D1 (AM) |
1. Read this report 2. Join Write the Docs Slack, introduce yourself 3. List 30 tech writers / doc leads on Twitter + LinkedIn 4. List 20 companies with docs you admire (check their docs tool) | Spreadsheet 50 prospects |
| D1 (PM) |
1. Post in Write the Docs #tooling: "What's the #1 thing you wish your docs tool did better?" 2. Send 15 DMs (Twitter + LinkedIn) 3. Write a tweet thread: "The stale docs problem: why 40% of your docs are wrong and you don't know it" | 15 DMs, thread posted, WtD post |
| D2-D3 |
1. Send 35 more DMs/emails (total 50) 2. Schedule first discovery calls 3. Start building a prototype (connect to a GitHub repo, calculate page freshness) | 50 contacts, calls scheduled, prototype started |
| D4-D5 |
1. Do 5-8 discovery calls 2. Reach 80 contacts 3. Identify top design partner candidates | Structured notes, candidates identified |
| D6-D7 |
1. Secure 3-4 design partners 2. Define MVP scope with them 3. Create a shared Slack channel or Discord with DPs | 3-4 design partners, MVP scope defined |
Week 2: Build the MVP (D8-D14)
| Day | Actions | Deliverable |
|---|---|---|
| D8 | Setup (repo, CI/CD, deploy, domain). Auth (GitHub OAuth). Connect GitHub repos. | App deployed, GitHub connected |
| D9-D10 | Crawl docs site (from URL or Git repo). Index all pages. Calculate freshness score (last edit date, code change proximity). | Docs indexed, freshness scores calculated |
| D11 | Dashboard: all pages sorted by staleness risk. Coverage gaps detection. | Dashboard functional |
| D12 | DP feedback call. AI review: compare doc content vs. recent code changes, flag mismatches. | AI staleness detection working |
| D13 | Slack alerts (when a doc becomes stale). Docs health score (0-100). | Alerts + health score |
| D14 | Tests, bugfix, onboard DPs with their real repos and docs. | MVP live with 3-4 real doc teams |
Week 3: Iterate (D15-D21)
| Day | Actions |
|---|---|
| D15 | DP feedback call. Prioritize top 3 requested features. |
| D16-D18 | Build requested features (likely: Confluence support, style guide checking, CI integration). Write docs for the tool itself (dogfooding). |
| D19-D20 | Stripe setup. Pricing page. Testimonials from DPs. Blog post: "How we helped [DP company] find 47 stale docs in 5 minutes". |
| D21 | Prepare launch: HN post, Twitter thread, Write the Docs announcement, email to 80 contacts. |
Week 4: Launch (D22-D30)
| Day | Actions |
|---|---|
| D22 - LAUNCH |
Post "Show HN: We built a staleness detector for documentation". Twitter thread + LinkedIn post. Write the Docs Slack announcement. Email all 80 contacts. Founder plan: Pro at $24/mo for life (100 spots). Target: 30 signups, 10 paid. |
| D23-D26 |
Support first users. Fix bugs. Write a second blog post. Ask DPs to share on Twitter/LinkedIn. Respond to every HN/Reddit comment. Contact 5 DevRel leads at API companies for the "free if you blog about it" offer. |
| D27-D30 |
Analyze metrics. Identify best acquisition channel. Plan Month 2: expand to more doc sources, add analytics, start content marketing. Target D30: 50 signups, 15 paid, $750 MRR. |
Summary
| Week | Goal | KPI |
|---|---|---|
| W1 | Validate + thread + DPs | 3-4 DPs, 80 contacts, Write the Docs presence |
| W2 | Build MVP | MVP live, 3-4 real doc teams onboarded |
| W3 | Iterate + prepare launch | Features shipped, Stripe, blog post, HN draft |
| W4 | Launch | 50 signups, 15 paid, $750 MRR |
12. 11. Tech stack
| Component | Choice | Why | Cost |
|---|---|---|---|
| Backend | Go or Node.js (Hono) | Fast, GitHub API, AI integrations | Free |
| Frontend | React (Next.js) | Dashboard SPA, good DX | Free |
| Database | PostgreSQL (Neon or Supabase) | Reliable, free tier | $0-25/mo |
| Hosting | Vercel + Railway or Fly.io | Auto-deploy, global | $0-30/mo |
| AI | Claude API | Best at reading code + docs and comparing. Long context window. | $20-100/mo |
| GitHub integration | GitHub App (webhooks + API) | Monitor repos, PRs, detect code changes | Free |
| Web crawling | Playwright or Cheerio | Crawl hosted docs sites | Free |
| Resend | Alerts, onboarding | Free to $20/mo | |
| Slack integration | Slack API (bot) | Staleness alerts in Slack | Free |
| Payment | Stripe | Standard | 2.9% + $0.30 |
| Analytics | PostHog | Product analytics | Free |
Month 1 infra budget: <$80
Key APIs
| API | Data | Access |
|---|---|---|
| GitHub API | Repos, PRs, commits, file changes, blame | Free (5,000 requests/hour with auth) |
| GitLab API | Same as GitHub | Free |
| Confluence API | Pages, spaces, last modified dates | Free with Atlassian account |
| GitBook API | Spaces, pages, content | Free (limited) |
| Notion API | Pages, databases | Free |
| Jira / Linear API | Issues, features (to detect "feature shipped but not documented") | Free |
13. 12. Metrics and milestones
Month-by-month
| Month | Signups | Paid | MRR | Milestone |
|---|---|---|---|---|
| M1 | 50 | 15 | $750 | MVP live, first real teams, HN launch |
| M2 | 120 | 35 | $1,800 | Confluence + GitLab support, first blog post ranking on Google |
| M3 | 250 | 70 | $3,500 | CI integration, Write the Docs conference talk/presence |
| M6 | 600 | 180 | $9,000 | Enterprise features (SSO, audit), first enterprise deal |
| M12 | 1,500 | 400 | $25,000 | Expanding to docs analytics, editing, or AI writing. Category leader for "docs freshness". |
Key insight: the tech writing market has extremely strong word-of-mouth. Tech writers talk to each other at conferences, in Slack, on social media. One satisfied customer at a well-known company (Stripe, Vercel, Cloudflare) can drive 50 signups.
Pivot signals
- Nobody connects their repo: the GitHub OAuth flow is scary. Add a "just enter your docs URL" mode.
- Users connect but don't come back: the freshness scores aren't actionable enough. Add "fix this" suggestions.
- Writers love it but can't get budget: pivot to targeting engineering managers or CTOs directly ("reduce support tickets by X%").
- The AI staleness detection is too noisy: too many false positives. Improve the model or add manual "ignore" rules.
14. 13. Verdict: where to start
Best bet: docs freshness engine
| Criterion | Score |
|---|---|
| Market size | ★★★★ (~20,000 teams with docs, growing) |
| Pain | ★★★★★ ("40% of our docs are wrong and we don't know which") |
| Willingness to pay | ★★★★ ($49-199/mo, engineering budgets) |
| Ease of contact | ★★★★★ (Write the Docs community, Twitter, LinkedIn) |
| Technical complexity | ★★★ (GitHub API + AI + crawling, moderate) |
| Competition | ★★★★★ (zero direct competitors) |
| Retention | ★★★★★ (once integrated into workflow, hard to remove) |
| Expansion | ★★★★★ (freshness → analytics → editing → full docs platform) |
| Virality | ★★★★ (health score badge, community word-of-mouth) |
Comparison with all 6 markets analyzed
| Criterion | Real estate agents | Notaries | YouTubers | Newsletters | SaaS owners | Tech writers |
|---|---|---|---|---|---|---|
| Market size | 35,000 | 7,400 | 8,000 | 1,500 | 5,000 | 20,000 |
| Avg ticket | $80-250 | $150-500 | $19-49 | $29-69 | $29-199 | $49-199 |
| Sales cycle | 1-7d | 7-30d | <1d | 1-3d | 1-7d | 7-14d |
| Churn | 5-8% | 1-3% | 8-12% | 5-8% | 3-6% | 3-5% |
| LTV | ~$2,000 | ~$10,000 | ~$500-1K | ~$1.5-3K | ~$3-8K | ~$3-6K |
| Feedback quality | Medium | Good | Medium | Good | Excellent | Exceptional |
| Community | Fragmented | Closed | Large | Growing | Active | Tight-knit (WtD) |
| Competition | Medium | Duopoly | Low (FR) | Low (FR) | Low (FR niche) | Zero (freshness) |
| Global potential | Difficult | Impossible | Easy | Easy | EU natural | Global from day 1 |
The technical writing market uniquely combines:
- Zero competition in the freshness/staleness niche
- Global from day 1 (English-first, universal problem)
- Best feedback quality of any market (writers are professional communicators)
- Tight community (Write the Docs = built-in distribution)
- High retention (once integrated into CI/workflow, very sticky)
- Natural expansion path (monitoring → analytics → editing → full platform)
- AI-native (LLMs are perfectly suited to "compare docs vs code")
The plan in one sentence
D1: join Write the Docs + viral thread on stale docs.
W1: 80 contacts, 3-4 design partners, prototype.
W2: build docs freshness engine (GitHub + AI + dashboard).
W3: iterate, add Slack alerts + CI, prepare HN launch.
W4: launch on HN + Twitter + WtD.
Target D30: 50 signups, 15 paid, $750 MRR.
What NOT to do
- Build another docs platform (GitBook/Mintlify are good enough, the editing market is crowded)
- Target enterprise day 1 (6-month sales cycles, SSO/SOC2 requirements)
- Build only for developers (technical writers are the underserved buyers, devs "just use Docusaurus")
- Ignore the Write the Docs community (it's your #1 distribution channel)
- Make a mediocre editor (writers will reject anything that's not at least as good as Google Docs)
- Generate AI docs without human review (wrong docs = worse than no docs)
- Forget to dogfood (your own docs should be the best example of what you sell)
- Price too low ($19/mo screams "toy", $49/mo says "professional tool")
Report generated on March 17, 2026 with the help of Claude. Market data are estimates based on public sources. The technical writing tools market is evolving rapidly, especially with AI integration.