SBML.org — the global portal for all things SBML

libSBML Project Labels

Since the libSBML projects on Pivotal Tracker tend to be extensive and experience has shown that it is better to keep all stories relating to libSBML in one project we need to have a labelling system that allows the stories to be effectively categorized.

General categories

Each story has a general category label from the following list:

Category Description
_admin Administrative tasks such as changing copyright year, organising directories etc
_build_sys Tasks related to building libSBML and the installers we produce.
_code Tasks related to actual code.
_design Tasks related to decisions on new function naming/functionality.
_docs Tasks related to documentation.
_testing Tasks related to testing the code.

Note: the underscore assures that this label is displayed first in the list of labels associated with a Pivotal story.


Each category has further labels that can more closely identify the nature of the task. In some cases these labels are applicable to more than one catgeory and so may appear in more than one list.

On some occasions it might be sensible to use another label (in addition to those below) to specifically identify tasks that are linked together; l3parser is an example of one such label.

_admin category

Category Description
decision A topic that needs debate/decision before it can be recategorised for action.


_build_sys category

Category Description
bindings Relating to all language bindings.
bindings-xyz Relating to the specific language binding 'xyz': c, csharp etc.
cmake Relating to cmake build code.
code-core Relating to libsbml core code.
code-packages Relating to all package code.
code-packages-abc Relating to code from the specific package 'abc': arrays, distrib etc.
dependencies Relating to libraries used by libSBML.
gnumake Relating to gnumake build code.
installers Relating to installers.
installers-xyz Relating to installers for the specific OS 'xyz': linux, mac etc.
linux Relating specifically to a linux OS.
mac Relating specifically to a mac OS.
win/windows Relating specifically to a windows OS.

Note: It is acceptable and even useful to use more than one of these labels for a story in the _build_sys category.

_code category

Category Description
annotations Relating to code that appears in the annotation subfolder of the libsbml or package src tree.
bindings Relating to all language bindings.
bindings-xyz Relating to the specific language binding 'xyz': c, csharp etc.
code-core Relating to libsbml core code.
code-packages Relating to all package code.
code-packages-abc Relating to code from the specific package 'abc': arrays, distrib etc.
compression Relating to code that appears in the compress subfolder of the libsbml src tree.
conversion Relating to code that performs conversion of some sort on an SBMLDocument.
design-issue An issue that involves a possible redesign of code or addition to the API.
examples Relating to code that appears in the examples subfolder of the libsbml or package src tree.
extension Relating to code that appears in the extension subfolder of the libsbml src tree.
math Relating to code that appears in the math subfolder of the libsbml or package src tree.
sbml-layer Relating to code that appears in the sbml subfolder of the libsbml or package src tree.
units Relating to code that appears in the units subfolder of the libsbml or package src tree.
validation Relating to code that appears in the validation subfolder of the libsbml or package src tree.
xml-layer Relating to code that appears in the xml subfolder of the libsbml or package src tree.

Note: It is acceptable and even useful to use more than one of these labels for a story in the _code category.

_design category

Category Description
new_api Relating to new functions proposed.
decision A topic that needs debate/decision before it can be recategorised for action.

Note: It is acceptable and even useful to use more than one of these labels for a story in the _design category.

_docs category

Category Description
bindings Relating to all language bindings.
bindings-xyz Relating to the specific language binding 'xyz': c, csharp etc.
code-core Relating to libsbml core documentation.
code-packages Relating to all package documentation.
code-packages-abc Relating to documentation from the specific package 'abc': arrays, distrib etc.
dependencies Relating to libraries used by libSBML.
docs-general Relating to general information parts of documentation.
installers Relating to installers.
linux Relating specifically to a linux OS.
mac Relating specifically to a mac OS.
tutorials Relating specifically to tutorials.
win Relating specifically to a windows OS.

Note: It is acceptable and even useful to use more than one of these labels for a story in the _docs category.

_testing category

Category Description
bindings Relating to all language bindings.
bindings-xyz Relating to the specific language binding 'xyz': c, csharp etc.
code-core Relating to libsbml core code.
code-packages Relating to all package code.
code-packages-abc Relating to code from the specific package 'abc': arrays, distrib etc.
test-autogen Relating to code that generates language binding tests.

Note: It is acceptable and even useful to use more than one of these labels for a story in the _testing category.

Retrieved from "http://sbml.org/SBML_Projects/How_we_use_Pivotal_Tracker/libSBML_Project_Labels"

This page was last modified 11:36, 30 September 2014.



Please use our issue tracking system for any questions or suggestions about this website. This page was last modified 11:36, 30 September 2014.