Our take
Maintaineda few commits in the last 90 days- Activity
- 32
- Community
- 77
- Issues
- 21
- Pull requests
- 46
+9 stars in the last 30 days
This is a broad, low-friction discovery list rather than a search or evaluation tool, and its recent activity suggests it is still maintained by a distributed contributor community.
Good fit if
- You want inspiration from real documentation across many developer domains.
- You need a starting point for exploring documentation-writing guidance or generation tools.
- You value a list that accepts community additions and provides context for many recommendations.
Look elsewhere if
- You need a ranked, categorized comparison or a guarantee that every linked resource is current.
- You are looking for one documentation generator or a ready-to-use documentation platform rather than a directory.
- You need documentation for a specific tool and prefer an authoritative source over a collection of external links.
All health signals
| Last commit | 2026-08-27 (2 months ago) |
|---|---|
| Commits, last 90 days | 6 |
| Releases, last 12 months | 0 |
| Contributors | 84 (top contributor: 39% of commits) |
| Issues closed, last 90 days | 0 |
| Pull requests merged, last 90 days | 2 |
| Project age | 14 years |
Checked on 2026-10-25 with the GitHub API.
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
9,548Forks
601Change since Nov 5, 2026: +1 stars·0 forks
Overview
beautiful-docs is a community-curated directory of developer documentation and related resources. It helps developers and documentation authors find examples of clear, usable docs to learn from when designing documentation for their own projects.
The collection also includes resources about writing documentation and tools for generating it. Links are listed in the order they were added, and the project invites pull requests with a short explanation and contributor attribution for each addition.
Key Features
- Curated examples spanning documentation for languages, frameworks, platforms, APIs, and other developer products.
- Separate collections for documentation examples, writing about documentation, and documentation-generation tools.
- Short descriptions explain what contributors value about many entries, such as navigation, examples, or organization.
- Direct links let readers explore the original documentation or tool.
- Contribution guidance encourages new links with context and attribution.
- Entries retain their addition order, making the list a history of community recommendations.
Use Cases
- A developer planning docs for a library can compare examples of API references, tutorials, and guides from other projects.
- A technical writer can browse the writing resources for guidance on content structure and style.
- A project maintainer choosing a documentation workflow can survey listed generators and publishing tools.
- A learner looking for approachable documentation for a particular language or platform can use the directory to discover examples.
License in plain words
MITpermissive
- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the copyright and license notice
- Share your changes: no
A summary, not legal advice: the LICENSE file is what applies.
Getting Started
Open the README and browse the sections for documentation examples, writing about docs, or generating docs. For details on adding a resource, follow the contribution guidance there.
Alternatives
- awesome-sphinxdoc: It focuses specifically on Sphinx extensions, themes, and tutorials, while beautiful-docs covers documentation examples and tools more broadly.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| beautiful-docs | – | MIT | 9.5k | Maintained |
| awesome-sphinxdoc | HTML | Other | 978 | Quiet |
Considerations
The project is a curated link collection, so the quality, availability, and currency of individual resources depend on their external maintainers. The repository has had a few commits recently and contributions from many people, but no release in the past year; releases are not central to using this list. It is MIT-licensed, which permits reuse subject to the license terms.
Found this useful?
Share it with someone who would like beautiful-docs.