Qual è la necessità di un libro di cucina invece di avere solo un manuale di riferimento? [chiuso]

Il libro di cucina di solito tratta temi e argomenti comuni, spesso quelli più popolari / richiesti tra gli utenti. Salterà del tutto alcuni argomenti (di solito quelli visti come oscuri / arcani), ma potrebbe impiegare molto tempo a trovare approcci diversi per risolvere lo stesso problema in circostanze diverse.

Il manuale di riferimento probabilmente cercherà di elencare tutto (o quasi tutto) in un'API / libreria, ma gli esempi forniti ( IF qualsiasi dato) saranno probabilmente banali, quanto basta per illustrare l'uso .

Esempio:

Un libro di ricette per un server web potrebbe mostrarti 5 modi diversi per configurare il tuo sito web per consentire HTTPS (forse per piattaforme / ambienti diversi, diverse impostazioni di sicurezza, ecc ...). La "ricetta" potrebbe non entrare in tutte le possibili opzioni di configurazione, solo le più comuni per questa attività.

Il manuale di riferimento elencherà tutte le possibili opzioni di configurazione necessarie per farlo, ma probabilmente non avrà un sacco di esempi dettagliati che gestiscono situazioni diverse.

Sono cose piuttosto diverse. Un manuale di riferimento semplicemente documenterebbe le interfacce a qualcosa. Un libro di cucina contiene esempi su come utilizzare le interfacce per ottenere risultati.

Alcuni libri di cucina si concentrano su specifici gruppi di problemi comuni e suggeriscono un modello di soluzione. Sono orientati al problema. Un manuale di riferimento tenta di elencare tutte le funzionalità. I manuali di riferimento sono per lo più orientati alle funzionalità rispetto ai problemi. Comunque. Tutto quanto sopra si basa sulla mia osservazione solo con i libri IT.