Diátaxis
Diátaxis — это системный подход к созданию технической документации, основанный на четырёх типах потребностей пользователей: учебники (tutorials), пошаговые инструкции (how-to guides), технические справочники (technical reference) и объяснения (explanation). Каждый тип решает конкретную задачу: от обучения новичков до углублённого понимания механизмов. Документация должна структурироваться вокруг этих четырёх форм, а не вокруг продуктов или технологий, что делает её более интуитивной и эффективной.
Методика не накладывает жёстких ограничений на формат или инструменты, но даёт чёткий принцип качества: каждая статья должна чётко соответствовать одной из четырёх категорий. Это упрощает работу авторов и поддержку документации. Практика подтверждает эффективность: компании вроде Vonage, Gatsby и Cloudflare перестроили свои документации по Diátaxis, что привело к росту удобства для пользователей и вовлечённости contributors. Участники отмечают, что структура помогает быстро находить нужный контент и решать, куда добавить новый материал.