User Tools

Site Tools


content:dev:reporting_bugs

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
content:dev:reporting_bugs [01/05/2013 19:41]
Andrew Bettison content:process:bugtracking renamed to content:dev:reporting_bugs (Deprecate "process" namespace)
content:dev:reporting_bugs [26/05/2013 21:25] (current)
Andrew Bettison [How to report a bug to the Serval Project] explanatory captions
Line 1: Line 1:
-====== Reporting Bugs ======+====== How to report a bug to the Serval Project ======
  
-Since September 2012, Serval Project related issues have been reported and tracked using [[https://github.com/blog/831-issues-2-0-the-next-generation|GitHub Issues]]. Each repository in GitHub has its own issue listso every issue must be associated with a single software component. Here are some common GitHub issue queries+When reporting a bug to the [[http://www.servalproject.org/|Serval Project]], please take the following steps
-  * **[[https://github.com/organizations/servalproject/dashboard/issues/repos?sort=updated&state=open|All open issues in all repositories]]** +  - Check if the bug is already known, by scanning the relevant issue lists: 
-  * [[https://github.com/servalproject/batphone/issues|All open Batphone issues]] +    * **[[https://github.com/organizations/servalproject/dashboard/issues/repos?sort=updated&state=open|All open issues in all repositories]]** 
-  * [[https://github.com/servalproject/serval-dna/issues|All open Serval DNA issues]] +    * [[https://github.com/servalproject/batphone/issues|All open Batphone issues]] -- for bugs in the [[:content:servalmesh:|Serval Mesh app for Android]] 
-  * [[https://github.com/servalproject/serval-tools/issues|All open Serval Tools issues]] +    * [[https://github.com/servalproject/serval-dna/issues|All open Serval DNA issues]] -- for bugs in underlying services (dor experienced developers) 
- +    * [[https://github.com/servalproject/serval-tools/issues|All open Serval Tools issues]] -- for bugs in software development tools (only of concern to developers)
-The former bug reporting and tracking system adopted in April 2012 was the Mantis Bug tracker. **MANTIS IS NOW DEPRECATED FOR ALL COMPONENTS.**  All issues originally reported in Mantis have been either closed or migrated to GitHub using [[https://github.com/servalproject/serval-tools/blob/master/doc/sp-mantis2github.md|sp-mantis2github]].  +
-  +
-==== How to report a bug ==== +
- +
-When reporting a bug, please take the following steps: +
-  - Check if the bug is already known, by scanning the relevant issue lists and reading any issues you find that appear relevant;+
   - If the bug is already reported, please add a comment to the existing issue;   - If the bug is already reported, please add a comment to the existing issue;
   - If the bug is not reported, please create a new issue;   - If the bug is not reported, please create a new issue;
Line 24: Line 18:
  
 ==== Where to report your bug ==== ==== Where to report your bug ====
 +
 +Since September 2012, the Serval Project has used [[https://github.com/blog/831-issues-2-0-the-next-generation|GitHub Issues]] to report and track bugs.  Each source-code repository in GitHub has its own issue list, so first you must choose the most suitable issue list for the bug:
  
   * To report a bug in the [[content:servalmesh:|Serval Mesh]] app for Android, please read about [[content:servalmesh:development#bug_tracking|Serval Mesh bug tracking]].  This will direct you to the relevant issue lists.   * To report a bug in the [[content:servalmesh:|Serval Mesh]] app for Android, please read about [[content:servalmesh:development#bug_tracking|Serval Mesh bug tracking]].  This will direct you to the relevant issue lists.
  
   * To report a bug in the [[content:servalmaps:main_page|Serval Maps]] app for Android, please [[:content:contact|Contact the Serval Project]].   * To report a bug in the [[content:servalmaps:main_page|Serval Maps]] app for Android, please [[:content:contact|Contact the Serval Project]].
 +
 +  * For all other bugs, please [[:content:contact|Contact the Serval Project]] directly.
  
 ==== After your bug is reported ==== ==== After your bug is reported ====
Line 40: Line 38:
    
 Please co-operate with our developers, as they have a lot of work to do, and remember that the Serval Project provides software free of charge thanks to generous donations from supporters and the hard work of team members and volunteers.  Your good manners, patience and understanding will be appreciated. Please co-operate with our developers, as they have a lot of work to do, and remember that the Serval Project provides software free of charge thanks to generous donations from supporters and the hard work of team members and volunteers.  Your good manners, patience and understanding will be appreciated.
 +
 +==== Historical note ====
 +
 +The Serval Project used the Mantis Bug tracker from April to September 2012. **MANTIS IS NOW DEPRECATED FOR ALL COMPONENTS.**  All issues originally reported in Mantis have been either closed or migrated to GitHub using [[https://github.com/servalproject/serval-tools/blob/master/doc/sp-mantis2github.md|sp-mantis2github]].
content/dev/reporting_bugs.1367462493.txt.gz · Last modified: 01/05/2013 19:41 by Andrew Bettison