Ross ROSS = Recommend OSS · open-source software intelligence for agents

evildmp/diataxis-documentation-framework resource

A systematic approach to creating better documentation. observed · 2026-08-28

github.com/evildmp/diataxis-documentation-framework · homepage · Python · NOASSERTION (other) observed · 2026-08-28

Health v2 · maintenance only

76/100

  • Activity 98
  • Release rhythm 35
  • Longevity 100

Flags: no_releases no_license

How is this computed?

round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.

  • gap_med: n/a
  • age_days: 2352
  • days_rel: n/a
  • days_push: 17
  • n_releases_24m: 0

Full methodology

Adoption not part of the score

1208 stars · 199 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Diátaxis is a systematic framework and methodology for organizing and authoring technical documentation, published as a website at diataxis.fr. It identifies four documentation forms - tutorials, how-to guides, reference, and explanation - and prescribes how to structure content around user needs.

Use cases

  • structure my project's documentation
  • decide what tutorials vs how-to guides vs reference to write
  • improve documentation quality and organization
  • learn a systematic approach to technical writing
  • reorganize messy docs into a clear architecture
  • train my team on documentation best practices

When to choose

  • you are writing or restructuring documentation for software or technical products
  • you want a lightweight, widely-adopted documentation framework without tooling constraints

When to avoid

  • you need a documentation generator or static site tool rather than a methodology
  • you need executable software - this is a guide/framework, not a tool

Facets

learning-resource · maturity stable

documentation documentation developer-tools diataxis technical-writing docs-as-code methodology framework web-server

2 sources

Member repositories

RepositoryRoleHealth v2
evildmp/diataxis-documentation-frameworkmain76

For agents

markdown · JSON · MCP: product_card(name="evildmp/diataxis-documentation-framework")

Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem