Come classificare le informazioni nella documentazione per l'utente finale?

Penso che tu abbia fatto un ottimo lavoro riassumendo la maggior parte dei tipi di documentazione in queste tre categorie. Vorrei aggiungere altri due:

Conoscenza per principianti / Bootstrapping

Potresti classificarlo sotto Ricette, ma penso che sia abbastanza diverso da meritare la sua categoria. Una ricetta presuppone già una conoscenza di base del sistema. Scrivere una ricetta per il cibo presuppone già una conoscenza di base del dominio di cucina: dovresti già sapere che cos'è un cucchiaino (se usi questo strano sistema di misure :)), come usare un forno, un forno a microonde, ecc.

Per qualcuno che non ha mai cucinato o prodotto cibo nella sua vita, vorrebbe una presentazione gentile dell'intero sistema, mostrando loro cosa possono fare e dando loro piccoli suggerimenti di freschezza lungo il percorso per mantenerli interessati.

Lo stesso vale per la documentazione. Un principiante rapidamente getterà via un libro di ricette, perché non hanno abbastanza conoscenza del dominio per apprezzare anche le ricette. Pertanto, hanno bisogno di alcune conoscenze per principianti o di bootstrap. Ecco alcuni punti su questo formato di documentazione:

• Molto semplice, assicurandosi di spiegare ogni possibile termine non familiare. Questo può essere frustrante per alcuni utenti, ma è essenziale per educare chiunque guardi alla documentazione
• Un sacco di piccoli esempi per mantenere l'utente interessato. Queste non sono ricette di per sé, ma sono piccole cose per mantenere il principiante interessato, sapendo che questo prodotto fa cose interessanti
• Un sacco di link ad altri posti nella documentazione (Ricette, Conoscenze degli esperti, ecc.) dove possono imparare di più su alcuni dei concetti discussi
• Abbastanza breve da essere facilmente digerito. Nessuno vuole leggere un romanzo introduttivo di 300 pagine

Marketing

Si potrebbe sostenere che questa non è realmente una "documentazione", ma spesso viene inclusa nella documentazione. Queste sono le descrizioni di "perché il nostro prodotto è così fantastico che dovresti usarlo". È una descrizione prolissa di come il prodotto supera la concorrenza. Questo è meno diffuso nel software open-source, ma lo vedete sempre nel software commerciale.

Diversamente varia se stai documentando software o hardware, ma possibilità:

1. Il tutorial (non del tutto simile a quello che chiami Ricetta, dipende dalla situazione). Ma almeno un breve tipo di "Hello World", e forse di più. Alcune persone imparano meglio dagli esempi. Altri girano a destra al riferimento
2. Installazione / trasformazione della cosa dannata su
3. Disinstallazione / disattivazione off
4. Interagire con altri "standard". Come funziona questo gizmo con Spring, XML, USB, Roku, LTE, CloudServices, ecc. Esiste un plugin Eclipse?
5. Pericoli / avvertenze / requisiti / trucchi. Non utilizzare sott'acqua, funziona, ma alcune opzioni sono disabilitate in Windows RT, richiede Java 6 o versioni successive, non funziona con IE6, non l'abbiamo testato su Android 2.2 e versioni precedenti, ecc.
6. FAQ, oltre a un link a qualsiasi aiuto in linea
7. Note legali (se necessario, si spera che possiate evitarle) Le parti sono concesse in licenza da FooBar Corporation, le parti sono GNU, Non per uso in diagnostica, ecc ...
8. Glossario (l'ho rubato dal commento di @ Marco)

Penso che Tutorial come categoria sia degna di distinzione dalle categorie elencate. Un tutorial non è una ricetta come l'hai descritta perché non è necessariamente un "come". Potrebbe essere una combinazione di "come", "perché" e "cosa" utilizzato per facilitare la comprensione di altri elementi. Una ricetta è solo "come" e sta da sola mentre un tutorial insegna un elemento che può essere completamente astratto e solo di qualsiasi uso in combinazione con altri elementi. In effetti si potrebbe anche considerare una ricetta come sottocategoria di Tutorial.

Penso che dovresti aggiungere una categoria " Indicizzazione ". Questo descrive il meccanismo per estrarre tutte le altre informazioni insieme tramite tag e collegamenti ipertestuali in modo che sia possibile accedervi in modo sensibile al contesto dall'applicazione e da un indice all'interno dell'applicazione. Se le informazioni non sono facilmente reperibili, gli utenti andranno su Google e salteranno la documentazione.