evildmp/diataxis-documentation-framework

A systematic approach to creating better documentation.

Python

1,254

324 commits

updated Oct 14, 2026

See the code

README

Diátaxis
========================

Diátaxis is a way of thinking about and doing documentation.

It prescribes approaches to content, architecture and form that emerge from a systematic approach to understanding the needs of documentation users.

Published at https://diataxis.fr

Author: `Daniele Procida <https://vurt.org>`_

I enjoy hearing about other people’s experiences with Diátaxis and read everything I receive.

I appreciate all the interest and do my best to reply, but I get a considerable quantity of email related to Diátaxis and I can’t promise to respond to every message.

If you’d like to discuss Diátaxis with other users, please see the `#diataxis <https://www.writethedocs.org/slack/> channel on the Write the Docs Slack group`_, or the `Discussions <https://github.com/evildmp/diataxis-documentation-framework/discussions>`_ section of `the GitHub repository for this website <https://github.com/evildmp/diataxis-documentation-framework>`_.

Licence: `CC-BY-SA 4.0 <https://creativecommons.org/licenses/by-sa/4.0/>`_

Not written in Markdown, so it's shown here as plain text — view it formatted on GitHub.

documentation

evildmp/diataxis-documentation-framework

A systematic approach to creating better documentation.

Python

1,254

324 commits

updated Oct 14, 2026

See the code

README

Diátaxis
========================

Diátaxis is a way of thinking about and doing documentation.

It prescribes approaches to content, architecture and form that emerge from a systematic approach to understanding the needs of documentation users.

Published at https://diataxis.fr

Author: `Daniele Procida <https://vurt.org>`_

I enjoy hearing about other people’s experiences with Diátaxis and read everything I receive.

I appreciate all the interest and do my best to reply, but I get a considerable quantity of email related to Diátaxis and I can’t promise to respond to every message.

If you’d like to discuss Diátaxis with other users, please see the `#diataxis <https://www.writethedocs.org/slack/> channel on the Write the Docs Slack group`_, or the `Discussions <https://github.com/evildmp/diataxis-documentation-framework/discussions>`_ section of `the GitHub repository for this website <https://github.com/evildmp/diataxis-documentation-framework>`_.

Licence: `CC-BY-SA 4.0 <https://creativecommons.org/licenses/by-sa/4.0/>`_

Not written in Markdown, so it's shown here as plain text — view it formatted on GitHub.

documentation

Significant stargazers

(top 24 of 59)

Titus

3,571 followers · starred Feb 2021

Mads Marquart

221 followers · starred May 2023

Yordis Prieto

276 followers · starred Dec 2021

Edward Faulkner

379 followers · starred Oct 2023