SourceForge Bug Tracker, Feature Request Tracker, And Support Tracker Categories And Groups


If you'd like to submit a bug report, feature request, or support request through SourceForge's system, this document explains the meaning of the category and group selections when entering an item in the database.

The patch tracking system at SourceForge is not used.  As explained here, the notion of the patch is not used in the ESRG release procedures.


Bug Tracker Categories And Groups

Bug Tracker Category

In brief, the category field of the bug tracking system is used to identify the product (Windows® tool set, *nix tool set, book, etc.) in which the problem exists.  The group field is used to identify the software version in which the problem exists.

Below is a screen snapshot showing how the choice of category is made when submitting a bug report.

The table below provides an explanation of all of the categories available.  Each category that can be selected when entering a bug into the bug tracker consists of a product (the rows of the table) combined with a column (the problem area of the product).

Product Area Exhibiting Bug Build CVS Install Source Use Content CGI
Product Exhibiting Bug 
*nixTsEsrg
(Product:  The Unix, Linux, Free BSD, etc. version of the ESRG tool set.  Mnemonic:  Unix tool set ESRG.)
Bugs in the *nix tool set build process, scripts, etc.  (Example:  *nix tool set does not build properly on a certain *nix platform.) Problems in the CVS archives of the *nix tool set.  (Example:  the tip of a certain archive is a file which will not compile.) Bugs in the *nix tool set installation downloads or installation process, scripts, etc.  (Example:  download will not untar on a certain platform or will not install on a certain platform.) Anomalies in the *nix tool set source code or scripts that have not been manifested in the build, installation, or tool behavior.  (Example:  source files that do not meet a coding standard, or documentation in the code which is incorrect.) Bugs in the operation of the *nix tool set itself.  (Example:  *nix tool set produces incorrect results, coredumps, etc.)

N/A

N/A

BkPracGuide
(Product: The book under construction, "A Practioner's Guide ...".  Mnemonic:  Book "Practitioner's Guide ...".)
The book does not build properly from LaTeX source code on some platform.   Problems in the CVS archives of the book  which are not content-related.

N/A

Bugs in the source code of the book which do not manifest themselves in the output.  (Example:  ill-advised LaTeX usage.)

Problems in the LaTeX or .PDF output of the book which are not related to technical content.  (Example:  lines which are too long and run into the margins.)

The content of the book is defective.  (Example: incorrect theorems, incorrect proofs, spelling errors, incorrect equation numbers cited, etc.)

N/A

EsLibEsrg
(Product: The embedded systems library of  the ESRG.  Mnemonic:  Embedded systems library ESRG.)
The library does not build properly on one of the recommended platforms with the recommended tools.   Problems in the CVS archives of the library  which are not content-related. Bugs in the library downloads or installation process, scripts, etc.  (Example:  installation .ZIP file will not unZIP using WinZip.) Anomalies in the library source code or scripts that have not been manifested in the build, installation, or library behavior.  (Example:  source files that do not meet a coding standard, or documentation in the code which is incorrect.) Bugs in the operation of the libraries.  (Example:  mathematical function produces incorrect result.)

N/A

N/A

WebSfEsrgTs
(Product:  ESRG tool set web content at SourceForge.  Mnemonic:  Web SourceForge ESRG tool set.)

N/A

N/A

N/A

N/A

N/A

The web at http://esrg.sourceforge.net is incorrect.  (Example: incorrect information, spelling errors, etc.) A CGI application at http://esrg.sourceforge.net does not work properly (Example:  The Euclid's GCD algorithm CGI-BIN script provides incorrect results.)
WinTsEsrg
(Product:  The Windows® version of the ESRG tool set.  Mnemonic:  Windows® tool set ESRG.)
The Windows® tool set does not build properly on one of the recommended platforms with the recommended tools.   Problems in the CVS archives of the Windows® tool set.  (Example:  the tip of a certain archive is a file which will not compile.) The Windows® installation does not work correctly on one of the supported platforms. Anomalies in the Windows® tool set source code or scripts that have not been manifested in the build, installation, or tool behavior.  (Example:  source files that do not meet a coding standard, or documentation in the code which is incorrect.) Bugs in the operation of the Windows® tool set itself.  (Example:  Windows® tool set produces incorrect results, protection faults, etc.)

N/A

N/A


Bug Tracker Group

The group field of the bug tracking system is used to identify the version of the software to which the bug should be attached.  The two choices are:

The screen snapshot below shows typical choices for the group field.  Note that no version number detail beyond major and minor version number is offered.

 


Feature Request Tracker Categories And Groups

Feature Request Tracker Category

The category field of the feature request tracker is used to indicate the product in which the feature addition is desired.  The screen snapshot below illustrates the choices available.  Note that the product mnemonics are the same as for the bug tracker category fields (described above).

The group field of the feature request tracker is used to indicate whether the feature is viewed as a long-term or a short-term feature.  The screen snapshot below indicates the choices available.

 


Support Tracker Categories And Groups

Support Tracker Category

The category field of the support tracker is used to indicate the product for which support is requested.  The screen snapshot below illustrates the choices available.  Note that the product mnemonics are the same as for the bug tracker category fields (described above).  Note also that CVS is included, to allow difficulties in interacting with the version control archives to be specified.

The group field of the support tracker is used to indicate the version number of the ESRG product with which support is requested.


This web page is maintained by David T. Ashley.
$Header: /cvsroot/esrg/sfesrg/esrgweba/htdocs/devels/sf_track_cats_grps/info_sf_track_cats_grps.htm,v 1.2 2003/04/27 08:11:08 dtashley Exp $