Tracker/it

L'indirizzo del nostro bug tracker è:

http://www.freecadweb.org/tracker

Potete segnalare i bug, presentare le richieste di funzionalità, patch, o richiedere di fondere un proprio ramo, se avete sviluppato qualcosa usando git. Il tracker è suddiviso in moduli, quindi cercate di essere specifici e di presentare la richiesta nella sottosezione appropriata. In caso di dubbio, lasciare il messaggio nella sezione "FreeCAD".

Prima di creare istanze, si prega di discutere sempre prima il bug nel Help forum e le richieste di nuove funzionalità in Open discussion forum.

Segnalare bug
Quando si pensa di aver trovato un bug, si è invitati a segnalarlo lì, se si è prima discusso la questione nelle sedi opportune.

Prima di segnalare un bug, si prega di verificare i seguenti punti:


 * Assicurarsi che il problema è veramente un bug, cioè, qualcosa che dovrebbe funzionare e che non funziona. Se non si è sicuri, non esitare a esporre il problema nel forum e chiedere cosa fare.
 * Prima di inviare qualsiasi cosa, leggere le FAQ - domande frequenti, fare una ricerca nel forum e assicurarsi che lo stesso bug non è ancora stato segnalato, facendo una ricerca nel bug tracker.
 * Descrivere il più chiaramente possibile il problema e come può essere riprodotto. Se non possiamo verificare il bug, potremmo non essere in grado di risolvere il problema.
 * Includere tutte le informazioni usando il pulsante "Copia negli Appunti" del menu Aiuto -> A proposito di FreeCAD e farlo sia dall'ambiente Parte che dall'ambiente PartDesign in modo che siano inseriti i dati sulla versione OCC o OCE del sistema operativo utilizzato.
 * Si prega di inviare una relazione separata per ogni bug.
 * Quando si usa un sistema Linux e il bug causa un crash in FreeCAD, si può provare a eseguire un debug backtrace: Da un terminale eseguire gdb freecad (supponendo che il pacchetto gdb è installato), poi, all'interno di gdb, digitare run. FreeCAD viene eseguito e probabilmente causa un crash. A crash avvenuto, digitare bt, per ottenere il backtrace completo. Accludere al rapporto sul bug il risultato del backtrace emesso.

Richiedere delle nuove funzionalità
Se desiderate qualcosa che in FreeCAD che non è ancora implementato, questo non è un bug, ma una richiesta di nuove funzionalità.

È possibile utilizzare il tracker anche per richiedere funzioni aggiuntive invece che per segnalare un bug, ma ricordate che non ci sono garanzie che il desiderio venga esaudito.

Inviare patch
Se avete creato il programma di correzione a un bug, una estensione o altro che può essere di uso pubblico in FreeCAD, create una patch utilizzando lo strumento Git diff e presentatela utilizzando il medesimo tracker (file di patch).

Richiedere la fusione
Se avete creato un ramo git contenente delle modifiche che desiderate far confluire nel codice di FreeCAD, potete fare la richiesta di avere la recensione e la fusione del vostro ramo, se ​​gli sviluppatori di FreeCAD sono d'accordo. È necessario pubblicare prima il ramo in un repository git pubblico (github, bitbucket, sourceforge ...) e poi fornire l'URL del vostro ramo nella richiesta di unione.

MantisBT Tips and Tricks
MantisBT (Mantis Bug Tracker) has it's own unique markup. Here is a list of useful ones:
 * @mention - works just like on GitHub where if you prepend '@' to someone's username they will receive an email that they have been 'mentioned' in a ticket thread
 * #1234 - By adding a hash tag in front of a number a shortcut to link to another ticket within MantisBT will present.
 * Note: if you hover over a ticket it will show you the summary + if the ticket is closed, it will be struck-through like #1234.
 * ~5678 - a shortcut that links to a bug note within a ticket. This can be used to reference someone's response within the thread. Each person that posts will show a unique ~#### number next to their username. If you look at the image in the example, you see that the shortcut is referencing the ticket number:comment number of said ticket
 *   - Using these tags will strikeout text.
 *   - To present a line or block of code, use this tag and it will colorize and differentiate it elegantly.
 * c:FreeCAD:git commit: - Part of the MantisBT Source-Integration plugin which will link to the FreeCAD GitHub git commit. c stands for 'commit'. FreeCAD stands for the FC GitHub repo. 'git commit' is the specific git commit hash to reference. Note: the trailing colon is necessary.
 * d:FreeCAD:diff: - similar to the above, but shows the diff
 * p:FreeCAD:pullrequest: - similar to the above but should show the Pull Request.