← Home
Open Source Docs Need Your Vote LLM-Powered Human-Curated 3 AI Drafts → Community Votes → Merged PR Stop Suffering Through Bad Documentation Open Source Docs Need Your Vote LLM-Powered Human-Curated 3 AI Drafts → Community Votes → Merged PR Stop Suffering Through Bad Documentation
It takes a town to raise great docs.

Docs are
broken.
Let's fix them
together.

Three AIs write the docs. The community picks the best one. The PR submits itself. Open source documentation has never been this easy — or this democratic.

Version A 142 votes

ActiveRecord::Base.connection_pool manages a pool of database connections that can be shared among threads. It provides thread-safe checkout and checkin of connections...

Version B 89 votes

The connection pool acts as a gatekeeper between your application and the database. Think of it as a checkout counter — threads borrow a connection, use it, and return it...

Version C 61 votes

# ConnectionPool — Manages reusable database connections. Key methods: checkout, checkin, with_connection. Configure via pool size in database.yml...

AI Writes It  →  Community Votes  →  PR Ships

How It Works

Four simple steps from documentation gap to merged pull request.

🔍

Discover

An LLM scans the codebase and identifies areas with missing, outdated, or thin documentation — methods, guides, config options that need love.

✍️

Draft × 3

Three independent LLMs each write their own version of the documentation. Different styles, different approaches, all covering the same gap.

🗳️

Vote

The community reviews all three versions and votes for the one that's clearest, most helpful, and best reflects how they want docs to read.

🚀

Ship

Once a version hits the vote threshold, the system auto-generates and submits a pull request to the project. Documentation improved. No fork required.

The Documentation Problem

Great code deserves great docs. But nobody wants to go through the hassle.

Today's Reality

  • Contributing docs requires forking, cloning, writing, and submitting PRs
  • Most developers just don't bother — the friction is too high
  • Critical methods go undocumented for years
  • Docs go stale as APIs evolve but nobody updates the text
  • LLMs alone can write docs, but who ensures quality?

With DocsTown

  • Contributing is as easy as reading and clicking a button
  • LLMs handle the heavy lifting of writing first drafts
  • Humans curate and validate — the best of both worlds
  • Weekly email digests keep contributors engaged
  • PRs auto-submit when the community reaches consensus
47%
Of public methods
lack documentation
Faster than
traditional PRs
2min
Average time
to cast a vote
0
Forks, clones, or
git commands needed

Not Another Issue Inbox

Tools like CodeTriage were a great start — they surface open issues and send daily emails. But they still drop you into the deep end of the traditional contribution workflow. DocsTown is fundamentally different.

Traditional Tools Manual
DocsTown Automated
Discovery
You browse open issues and hope to find one you understand
LLMs scan the codebase and identify documentation gaps automatically
Writing
You write the docs from scratch — reading source code, tests, and prior art
3 LLMs draft independent versions. You just read and vote.
Git Workflow
Fork → Clone → Branch → Write → Commit → Push → Open PR
Click a button. That's it.
Time
30 min – 2 hours per contribution
2 minutes to read and vote
Quality
Relies on maintainer review (often backlogged)
Community consensus + maintainer final approval
PR Submission
Manual — you manage the entire PR lifecycle
Automatic — system submits when vote threshold is reached

We love what CodeTriage started. DocsTown picks up where manual contribution tools leave off.

Built For Projects Like

Any open source project with documentation debt — which is basically all of them.

Frameworks

Ruby on Rails

Thousands of methods across ActiveRecord, ActionPack, and ActionMailer with sparse or missing docs. The perfect candidate.

Languages

Any OSS Project

From React to Django to Phoenix — every open source project struggles with documentation debt. DocsTown is framework agnostic.

Libraries

Your Favorite Gem

Small libraries often have zero docs beyond a README. DocsTown makes it trivially easy to give them the documentation they deserve.

No Git Required Vote in 2 Minutes Ship Better Docs
✨ Early Access

Ready to fix
open source docs?

Join the waitlist. Get weekly documentation tasks delivered to your inbox. Vote on the best docs. Make open source better.