Compreendendo o Diátaxis
A Grande Teoria Unificada da Documentação
— David Laing
As páginas desta seção têm como objetivo fornecer fundamentação teórica para as práticas que o Diátaxis prescreve, além de explorar algumas das questões que ele levanta.
Dentro da disciplina de documentação, o discurso tende para o prático e o concreto. A abordagem é geralmente heurística: diretrizes, regras práticas, imperativos específicos, princípios que sabemos que funcionam.
Como profissionais, temos muito a dizer sobre o que fazer, como fazer e como funciona, e relativamente pouco a dizer sobre o porquê de funcionar. Nossa percepção sobre a maneira correta de fazer as coisas baseia-se amplamente 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 sob uma base teórica mais rigorosa.
Nesta seção
Estas páginas aprofundam-se no pensamento que sustenta o Diátaxis.
-
Fundamentos - por que o Diátaxis funciona
-
O mapa - documentação em duas dimensões
Problemas comuns explorados: