Differences between revisions 10 and 12 (spanning 2 versions)
Revision 10 as of 2014-07-19 19:17:14
Size: 7351
Comment: sync with English master
Revision 12 as of 2017-06-18 17:55:51
Size: 8057
Comment: sync with english master
Deletions are marked like this. Additions are marked like this.
Line 66: Line 66:
 * http://planeta.debian.net - Planeta Debian, un aggregatore di blog in spagnolo;  * http://planet.debian.org/es/ - Planeta Debian, un aggregatore di blog in spagnolo;
Line 121: Line 121:
La maggior parte della documentazione Debian è disponibile all'indirizzo http://www.debian.org/doc/ddp  {i} Questo è software libero, __si può contribuire con miglioramenti alla documentazione esistente__ ~-<<BR>>''(cioè non è necessario scrivere un proprio HowTo!)''-~.
Line 123: Line 123:
se si è interessati a contribuire, è possibile leggere le mailing list:
 * http://lists.debian.org/debian-www/recent
 * http://lists.debian.org/debian-doc/recent
 
 .
 
 {i} Questo è free software,__tu puoi aiutare a migliorare la documentazione__ ~-<<BR>>''(cioè non devi scrivere il tuo Howto personale!)''-~.
Se si è interessati a contribuire alla documentazione, controllare prima le seguenti risorse, per avere un'idea di come gli altri contribuiscono:
 * http://www.debian.org/doc/ddp (la maggior parte della documentazione di Debian è disponibile lì)
 * https://wiki.debian.org/ (unirsi a chi lavora al wiki e aggiungere nuovi contenuti o traduzioni)
 * http://lists.debian.org/debian-www/recent ([[it/DebianMailingLists|mailing-list]])
 * http://lists.debian.org/debian-doc/recent ([[it/DebianMailingLists|mailing-list]])

 {i} Alcuni contenuti della documentazione vengono generati dai corrispondenti pacchetti Debian. Se è così si potrebbe voler interagire con il manutentore del pacchetto. A volte inviare una segnalazione di bug usando il [[it/BTS|Sistema di tracciamento dei Bug di Debian (BTS, Bug Tracking System)]] è una buona idea.

Se si è interessati a partecipare al gruppo debian-doc, vedere la [[Teams/DDP|pagina del team nel wiki]]
Line 135: Line 137:
= Si veda anche = = Vedere anche =

Translation(s): English - Français - Italiano


Debian è una distribuzione costituita da molte migliaia di programmi liberi.

Questa pagina tratta della Documentazione ufficiale Debian.

Esistono anche altre risorse Debian.

Documentazione Debian

Per gli utenti

La documentazione più famosa per utenti Debian è:

Molta altra documentazione per Debian è disponibile all'indirizzo www.debian.org/doc

Per il momento, Debian non ha un manuale per Amministratore di Sistema.

Per i collaboratori

La documentazione più famosa per i collaboratori Debian è :

La maggior parte della documentazione per gli sviluppatori Debian (e per i manutentori dei pacchetti) è disponibile su www.debian.org/devel/.

Siti ufficiali del Progetto Debian

Il Progetto Debian ha una costituzione e una struttura organizzativa.

Su Debian.org, sito ufficiale di Debian, si può trovare una sezione specificamente dedicata alla documentazione.

Forum

Advocacy, sviluppatori, informazioni interne

Wiki

Debian Related Wikis

Books

Molti libri liberi e non sono elencati sul sito internet di Debian.

Ulteriori libri possono essere elencati qua sotto.

Instant Messaging

Esistono canali IRC ufficiali di Debian.

È possibile anche usare Jabber

Documentazione programmi

Ciascun programma fornisce la sua documentazione specifica.

Sotto Debian (Unix), la documentazione di un programma consiste, in genere, di uno o più dei seguenti elementi:

  • una pagina man (digitare man seguito dal nome del comando).

  • un file README, fornito dalla versione originale. (È un file di testo che si trova al percorso /usr/share/doc/pkgname/README)

  • un file README.Debian, fornito dal maintainer del pacchetto Debian. (È un file che si trova al percorso /usr/share/doc/pkgname/README.Debian)

  • i programmi dotati di interfaccia grafica (Gnome, KDE...) di solito hanno delle pagine di aiuto (raggiungibili tramite Menu > Help).

  • alcuni programmi forniscono la propria documentazione in formato html, o sotto forma di pagina info.

Descrizione dei pacchetti

Nella descrizione di un pacchetto si possono trovare alcune informazioni utili, come una breve descrizione del pacchetto stesso, un link al sito del progetto, un elenco dei file contenuti al suo interno, e molto altro. Si può accedere alla descrizione di un pacchetto tramite l'url http://packages.debian.org/<package-name> , oppure provando "aptitude show $PKG" (potrebbe essere necessario eseguire prima un "apt-get update && apt-get aptitude && aptitude update").

Uno dei modi più indicati per trovare un aiuto per un singolo pacchetto o applicazione è leggere il contenuto di /usr/share/doc/<package-name> (in particolare il file README.Debian). Questa documentazione è stata scritta dagli sviluppatori o dai manutentori dei pacchetti ed è abbastanza sintetica ma, normalmente, menziona i problemi più comuni e le relative soluzioni, le nuove funzionalità e i bug risolti.

Sistema di tracciamento dei bug (BTS)

La soluzione a molti problemi può essere trovata sotto forma di risposte alle segnalazioni dei bug. Un motore di ricerca per le segnalazioni di bug si trova su http://bugs.debian.org ; se si desidera ricercare tra i bug archiviati (quelli abbastanza vecchi) bisogna scegliere l'opzione "bug archiviati". Per guardare i bug relativi ad un pacchetto specifico si può usare http://bugs.debian.org/<package-name>.

Contribuire alla documentazione

  • {i} Questo è software libero, si può contribuire con miglioramenti alla documentazione esistente
    (cioè non è necessario scrivere un proprio ?HowTo!)
    .

Se si è interessati a contribuire alla documentazione, controllare prima le seguenti risorse, per avere un'idea di come gli altri contribuiscono:

Se si è interessati a partecipare al gruppo debian-doc, vedere la pagina del team nel wiki

Vedere anche