Skip to content

Latest commit

 

History

History
56 lines (32 loc) · 2.87 KB

colophon.rst

File metadata and controls

56 lines (32 loc) · 2.87 KB

Colophon

Diátaxis is the work of Daniele Procida.

It has been developed over a number of years, and continues to be elaborated and explored.

Contact me

Email me. 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 channel on the Write the Docs Slack group, or the Discussions section of the GitHub repository for this website.

Origins and development

You can find an earlier presentation of some of these ideas, that I created while working at Divio between 2014-2021. I still agree with most of it, though there are several aspects that I now think I got wrong.

The original context for the Diátaxis approach was limited to software product documentation.

In 2021 I was awarded a Fellowship of the Software Sustainability Institute, to explore its application in scientific research contexts. More recently I've explored its application in internal corporate documentation, organisational management and education, and also its application at scale. This work is on-going.

Other people have corresponded with me to share their experience of applying Diátaxis to note-taking systems and even as part of a systematic approach to household management.

Citation and contribution

To cite Diátaxis, please refer to :doc:`this website, diataxis.fr <index>`.

The Git repository for the source material contains a citation file, CITATION.cff.

APA and BibTeX metadata are available from the Cite this repository option at https://github.com/evildmp/diataxis-documentation-framework.

You can also submit a pull request to suggest an improvement or correction, or file an issue.

Diátaxis is now used in several hundred projects and it is no longer possible for me to keep up with requests to have projects listed here as examples of Diátaxis adoption.

Website

This website is built with Sphinx and hosted on Read the Docs, using a modified version of Pradyun Gedam's Furo theme.