PharkMillups

beautiful-docs: Find Inspiring Developer Documentation

A community-maintained list of useful, well-written developer documentation, plus resources about writing and generating docs. Browse it for examples and tools when creating documentation for a project.

View on GitHub Compare
Stars
9.5k
Forks
600
Stars, last 30 days
+9
Last commit
2 months ago
Contributors
84

Our take

Maintaineda few commits in the last 90 days

Health score

44/100

How it is scored
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 commit2026-08-27 (2 months ago)
Commits, last 90 days6
Releases, last 12 months0
Contributors84 (top contributor: 39% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days2
Project age14 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.

Selected snapshot

Stars

9,548

Forks

601

Change 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.
ProjectLanguageLicenseStarsStatus
beautiful-docs–MIT9.5kMaintained
awesome-sphinxdocHTMLOther978Quiet

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.

Comparisons