Entendendo o Diátaxis
A Grande Teoria Unificada da Documentação
—David Laing
As páginas nesta seção têm como objetivo fornecer uma base teórica para as práticas prescritas pelo Diátaxis e explorar algumas das questões que ele levanta.
Dentro da disciplina de documentação, o discurso tende a ser prático e concreto. A abordagem é geralmente heurística: diretrizes, regras práticas, imperativos específicos e princípios que sabemos que funcionam.
Como praticantes, temos muito a dizer sobre o que fazer, como fazer e como funciona, e relativamente pouco a dizer sobre por que funciona. Nossa noção da maneira correta de fazer as coisas é baseada em grande parte em uma combinação de intuição e experiência. O aspecto teórico da disciplina recebe muito menos atenção.
O Diátaxis visa colocar a prática de documentação em uma base teórica mais rigorosa.
Nesta seção
Estas páginas aprofundam o pensamento que fundamenta o Diátaxis.
-
Fundamentos - por que o Diátaxis funciona
-
O mapa - documentação em duas dimensões
Problemas comuns explorados: