Колофон¶

Этот подход развивался на протяжении нескольких лет; его продолжают развивать и исследовать.

Свяжитесь со мной¶

Напишите мне. Мне интересно узнавать, как другие люди работают с Diátaxis, и я читаю каждое полученное сообщение.

Я ценю ваш интерес и стараюсь отвечать, но получаю очень много писем о Diátaxis, поэтому не могу обещать ответ на каждое сообщение.

Если вы хотите обсудить Diátaxis с другими пользователями, посетите канал #diataxis в Slack-сообществе Write the Docs или раздел Обсуждения в репозитории этого сайта на GitHub.

Истоки и развитие¶

Существует более раннее изложение некоторых из этих идей, которое я подготовил, работая в Divio с 2014 по 2021 год. Я по-прежнему согласен с большей его частью, хотя теперь считаю некоторые положения ошибочными.

Изначально подход Diátaxis применялся только к документации программных продуктов.

В 2021 году я стал стипендиатом Software Sustainability Institute, чтобы исследовать применение Diátaxis в научной работе. Позднее я изучал применение подхода во внутренней корпоративной документации, организационном управлении и образовании, а также его использование в больших масштабах. Эта работа продолжается.

Мне также писали люди, применявшие Diátaxis в системах ведения заметок и даже как часть системного подхода к ведению домашнего хозяйства.

Цитирование и участие¶

При цитировании Diátaxis ссылайтесь на этот сайт — diataxis.fr.

Git-репозиторий исходных материалов содержит файл цитирования CITATION.cff.

Метаданные в форматах APA и BibTeX доступны через пункт Cite this repository на странице https://github.com/evildmp/diataxis-documentation-framework.

Предложить улучшение или исправление можно, отправив пул-реквест либо создав задачу.

Сейчас Diátaxis используется в нескольких сотнях проектов, поэтому я уже не успеваю добавлять сюда проекты по просьбам их авторов в качестве примеров применения подхода.

Сайт¶

Этот сайт собран с помощью Sphinx, размещён на Read the Docs и использует изменённую версию темы Furo Прадьюна Гедама.