Progetto per la documentazione di GnuCash

Questa è la pagina principale del progetto per la documentazione di GnuCash; l'obiettivo che si prefigge è quello di mantenere una comunità di persone che lavorano alla realizzazione di documentazione di elevata qualità per GnuCash

Tutto il necessario, relativamente alla documentazione di GnuCash, dovrebbe essere qui. Se si nota la mancanza di qualcosa, inviare una mail a gnucash-devel e qualcuno si occuperà di aggiungerla.

Documentazione compilata in notturna

L'attuale documentazione instabile dell'utente e dello sviluppatore

Ogni notte un server compila la documentazione partendo dal contenuto del deposito SVN di GnuCash. Sono incluse la documentazione per gli sviluppatori di Doxygen e la documentazione dell'utente relativa all'attuale versione instabile di GnuCash.

Documentazione compilata in notturna:

GnuCash v2.0 (rilascio stabile attuale)

Se si ha una domanda relativa all'utilizzo di GnuCash, si è nel posto giusto. Per prima cosa, si dovrebbe leggere il manuale di aiuto e la guida ai concetti; la maggior parte delle domande potrebbero trovare risposta in questi documenti.

Il manuale di aiuto è pensato per costituire un rapido riferimento su come compiere delle operazioni specifiche e su come utilizzare le caratteristiche di GnuCash. La guida ai concetti costituisce invece un approfondimento dei concetti che stanno alla base dell'utilizzo di GnuCash; essa illustra anche un esempio guidato su come mettere in pratica questi concetti.

Manuale di aiuto
- Inglese (HTML)
- Tedesco (HTML)
Guida ai concetti
- Inglese (HTML)

Inviare una mail alla mailing list gnucash-user se non si è avuta una risposta soddisfacente al proprio quesito nel manuale di aiuto e nella guida ai concetti. Abbiamo bisogno dei vostri commenti, dato che che solo attraverso di essi possiamo capire come modificare la documentazione.

In aggiunta, è possibile discutere con qualcuno, relativamente alla propria domanda, tramite IRC nel canale "#gnucash" su irc.gnome.org. Ulteriori risorse sono le wiki Inglese o Tedesca di GnuCash. Una wiki è un sito web interattivo in cui gli utenti registrati possono rispondere o proporre delle domande.

Alcune persone hanno preparato delle guide e degli esempi guidati. Nota: le informazioni presenti in queste fonti possono o non possono essere aggiornate alla versione più recente di GnuCash. Se si è interessati a sviluppare questi documenti, si dovrebbe prima contattare l'autore originale.

Vecchia documentazione di GnuCash

Questa sezione contiene tutta la vecchia documentazione di GnuCash. Se si sta utilizzando una di queste vecchie versioni di GnuCash, si raccomanda caldamente di aggiornarla all'ultima versione stabile.

GnuCash v1.8:
GnuCash v1.6: Inglese | Tedesco | Spagnolo | Portoghese

Sviluppo della documentazione

Collegamenti di interesse

I collegamenti seguenti sono relativi ad altri siti che possono essere di aiuto per i processi di creazione e di revisione della documentazione.

Per revisori e autori di documentazione

Leggere le seguenti guide. La nuova documentazione è basata sul sistema docbook GNOME2 XML. Se si desidera contribuire, si consiglia di seguire queste guide, dove possibile, al momento della revisione o della stesura della documentazione.

Si consiglia anche l'iscrizione a gnucash-devel.

Revisori

Controllare il modulo della documentazione dal deposito svn di GnuCash dedicato: /gnucash-docs. Se non si ha familiarità con il sistema svn, la wiki di GnuCash ne riporta una descrizione. L'unica modifica da effettuare per ottenere la documentazione, consiste nell'utilizzare il comando «checkout gnucash-docs» in luogo di «checkout gnucash». In alternativa si può partire dal file scaricabile del pacchetto della documentazione.

Il miglior modo per sottoporre in maniera semplice le proprie osservazioni relative alla documentazione, consiste nell'utilizzo di bugzilla.gnome.org: qui è possibile inserire un bug indicandolo come relativo alla documentazione. Questo può avvenire anche utilizzando "bug-buddy".

Autori

Si consiglia di controllare anche la documentazione nel deposito svn come descritto più sopra. La normale procedura per chi desidera contribuire al progetto GnuCash, consiste dapprima nell'invio di patch alla mailing list gnucash-devel.Qualcuno si occuperà di applicare le patch al deposito svn fino a quando non verrà fornito un account. Le patch possono anche essere aggiunte direttamente nella relativa segnalazione su bugzilla.

Si consiglia di rendere noto agli altri autori la sezione su cui si desidera lavorare. La richiesta deve essere fatta sulla lista gnucash-devel in modo che le altre persone interessate possano dare il via libera o comunicare che quella particolare sezione è già assegnata a qualcun altro.

Può anche risultare utile mantenere una copia locale della vecchia documentazione come riferimento per la scrittura: essa contiene ancora una grande quantità di informazioni utili che non sono ancora state trasferite nella nuova documentazione.