Contribuire

From FreeCAD Documentation
Revision as of 14:34, 2 June 2011 by Maegras (talk | contribs)

Ci sono molti modi per contribuire allo sviluppo e alla crescita di FreeCAD, anche se non si conosce il linguaggio di programmazione Python.

Migliorare la Documentazione

Si può, ad esempio, aiutare a migliorare la documentazione del programma, correggere ed estendere i capitoli esistenti oppure creare nuove pagine per spiegare l'utilizzo di una determinata funzione del programma, se questa non viene spiegata in nessuna altra pagina. Per lavorare sulla documentazione è necessario interagire con il Wi``Ki attraverso un account SourceForge. Una volta registrato un account sarà necessario richiedere ai responsabili del progetto i permessi di editare il Wi``Ki, attraverso il forum oppure attraverso il canale #IRC. Alcune aree che necessitano di essere ampliate e migliorate sono:

  • La Lista dei Comandi che include al suo interno tutti i comandi utilizzabili in FreeCAD. Molti di questi non hanno ancora una descrizione oppure, se esiste, è molto scarna. La pagina del comando Cattura Schermata è un ottimo punto di partenza per costruire una adeguata descrizione.
  • La sezione dei Tutorial è ancora molto esigua. Se si sviluppa o si realizza qualcosa di interessante con FreeCAD sarebbe molto utile scrivere una guida e pubblicarla in questo capitolo della documentazione.


Tradurre la documentazione oppure il programma stesso

  • Si può tradurre FreeCAD nella propria lingua. Tutte le stringhe di testo del programma possono essere facilmente tradotte. Manca solo il contributo dei traduttori :)
  • Per tradurre il manuale di utilizzo di FreeCAD basta seguire questi semplici passi:
    • Loggarsi nel Wi``Ki;
    • Cercare una pagina non ancora tradotta nella propria lingua;
    • Aggiungere, nell ULR, il suffisso /it;
    • Copiare il contenuto della pagina inglese originale e iniziare la traduzione.

Un Esempio
Si ipotizzi di voler tradurre la pagina Part_Module in italiano. Il suo URL, che può essere letto nella barra degli indirizzi del Browser, è https://sourceforge.net/apps/mediawiki/free-cad/index.php?title=Part_Module. È sufficiente aggiungere un /it alla fine dell'URL per creare la nuova pagina sulla quale avviare la traduzione. Il link della pagina in italiano sarà quindi:
https://sourceforge.net/apps/mediawiki/free-cad/index.php?title=Part_Module/it.


Far conoscere FreeCAD

  • Si può parlare a amici e colleghi di FreeCAD.
  • Trovare utilizzi interessanti e "non convenzionale" del programma e documentarli, ed esempio con l'utilizzo degli screenshots. FreeCAD è ancora molto giovane è non tutti sono in grado di capire a prima vista gli scopi per cui può essere utilizzato. Un'immagine vale più di mille parole.
  • Frequentare il forum ed aiutare i nuovi utenti con le operazioni di base.
  • Scrivere tutorial, registrare video, mostrare a tutti cosa si può fare con FreeCAD.
  • Contribuire con i propri disegni, schizzi o estrusioni 3D.


Segnalare BUGs e suggerire nuove funzionalità

  • Si possono segnalare bug, quando se ne trovano, basta essere sicuri che quello che si sta segnalando sia effettivamente un Bug, ovvero un qualcosa che dovrebbe realizzare una determinata azione, che invece non accade. È inoltre necessario descrivere come il bug si è presentato, in modo che uno sviluppatore sia in grado di riprodurlo e correggerlo.
  • Suggerire nuove funzioni. Non è detto che queste verranno implementate, ma possono in ogni caso suggerire buone idee agli sviluppatori. Prima di segnalare la propria richiesta sarebbe utile discuterne con gli altri utenti nel forum.


Scrivere codice

  • Se si conosce il Python si possono scrivere interessanti scripts per rimediare a piccole funzioni non ancora implementate oppure per costruire qualche nuovo strumento.
  • Se invece si conosce il C++, allora si possono fare grandi cose. Si visiti il Developer hub per saperne di più!
Altre lingue: