Documentazione<Precedenti | Contenuti | Succ.>
6.1. Fonti di documentazione
Prima di poter capire cosa sta realmente accadendo quando si verifica un problema, è necessario conoscere il ruolo teorico svolto da ciascun programma coinvolto nel problema. Uno dei modi migliori per farlo è rivedere la documentazione del programma. Cominciamo discutendo dove, esattamente, puoi trovare la documentazione poiché è spesso sparsa.
Come evitare RTFM Questo acronimo sta per "read the f *** ing manual", ma può anche essere espanso in a Risposte variante più amichevole, "leggi il manuale fine". Questa frase è talvolta usata nelle risposte (concise) alle domande dei neofiti. È piuttosto brusco e tradisce un certo an-
fastidio per una domanda posta da qualcuno che non si è nemmeno preso la briga di leggere la documentazione. Alcuni dicono che questa risposta classica è meglio di nessuna risposta poiché questo almeno suggerisce che la risposta si trova all'interno della documentazione.
Quando pubblichi domande, non essere necessariamente offeso dall'occasionale risposta RTFM, ma fai il possibile per dimostrare almeno che hai dedicato del tempo a fare qualche ricerca prima di pubblicare la domanda; menziona le fonti che hai consultato e descrivi i vari passaggi che hai personalmente intrapreso per reperire informazioni. Questo farà molto per dimostrare che non sei pigro e stai veramente cercando la conoscenza. Seguire le linee guida di Eric Raymond è un buon modo per evitare gli errori più comuni e ottenere risposte utili.
➨ http://catb.org/~esr/faqs/smart-questions.html
Come evitare RTFM Questo acronimo sta per "read the f *** ing manual", ma può anche essere espanso in a Risposte variante più amichevole, "leggi il manuale fine". Questa frase è talvolta usata nelle risposte (concise) alle domande dei neofiti. È piuttosto brusco e tradisce un certo an-
fastidio per una domanda posta da qualcuno che non si è nemmeno preso la briga di leggere la documentazione. Alcuni dicono che questa risposta classica è meglio di nessuna risposta poiché questo almeno suggerisce che la risposta si trova all'interno della documentazione.
Quando pubblichi domande, non essere necessariamente offeso dall'occasionale risposta RTFM, ma fai il possibile per dimostrare almeno che hai dedicato del tempo a fare qualche ricerca prima di pubblicare la domanda; menziona le fonti che hai consultato e descrivi i vari passaggi che hai personalmente intrapreso per reperire informazioni. Questo farà molto per dimostrare che non sei pigro e stai veramente cercando la conoscenza. Seguire le linee guida di Eric Raymond è un buon modo per evitare gli errori più comuni e ottenere risposte utili.
➨ http://catb.org/~esr/faqs/smart-questions.html