Zrozumienie Diátaxis¶
Wielka Zunifikowana Teoria Dokumentacji
—David Laing
Strony w tej sekcji mają na celu dostarczenie pewnego teoretycznego podłoża dla praktyk, które zaleca Diátaxis, oraz zbadanie niektórych pytań, które podnosi.
W ramach dyscypliny dokumentacji dyskurs zmierza ku praktycznemu i konkretnemu. Podejście jest zazwyczaj heurystyczne: wytyczne, reguły kciuka, konkretne nakazy, zasady, które wiemy, że działają.
Jako praktycy mamy dużo do powiedzenia na temat tego, co robić, jak to robić i jak to działa, a stosunkowo niewiele do powiedzenia na temat dlaczego to działa. Nasze poczucie właściwego sposobu robienia rzeczy opiera się w dużej mierze na połączeniu intuicji i doświadczenia. Teoretyczny aspekt dyscypliny otrzymuje znacznie mniej uwagi.
Diátaxis ma na celu umieszczenie praktyki dokumentacji na bardziej rygorystycznym teoretycznym gruncie.
W tej sekcji¶
Te strony zagłębiają się w myślenie, które stanowi podstawę Diátaxis.
Fundamenty - dlaczego Diátaxis działa
Mapa - dokumentacja w dwóch wymiarach
Wspólne problemy zbadane: