JSBML - the Java™ library for working with systems biology models in SBML format #4
Labels
end-user tutorial
Tutorials for software users
enhance
Update existing docmentation
user manual
Manual for software users
web site content
Content for specific web pages
Background
The file format SBML constitutes the de facto standard exchange format for computational models in computational systems biology. It has been established nearly two decades ago and quickly gained popularity. Nowadays, many scientific journals require models in that format to be uploaded as supplementary information of publications about computer models in systems biology. However, SBML has not been developed to be manually written. Instead, these files should be created and manipulated using algorithms and specialized software.
The JSBML project's aim is to provide an SBML parser and library that maps all SBML elements to a flexible and extended type hierarchy. Currently, JSBML supports all constructs for SBML up to the latest Level 3 Version 2 specification, including an API to add support for SBML Level 3 extension packages for advanced modeling techniques.
The documentation of the JSBML project is currently distributed across a few resources, including a website, a users' guide in PDF format, a GitHub page, and an entry in Wikipedia. In addition, JavaDoc is used to explain the detailed functions of the source code directly. For users, it is currently difficult to get started with the library. We have observed that while the users' guide provides the most comprehensive overview of the project, most new users do not entirely read it up front, but use a combination of Google and resources such as StackOverflow to answer specific questions.
Goal
We are therefore considering creating a cookbook-like resource in addition to improving the users' guide. We also plan to have more cross-links between different locations of documentation available, so that users may more quickly find information. We also need to avoid that users of JSBML are mistakenly directed to solutions based on the Java API wrapper of the complementary C/C++ library libSBML. In some cases, libSBML can be used to solve problems in Java, but it is not recommendable because of the compromised platform independence this native library introduces.
We need to identify common use cases of JSBML and to provide questions and answers, code examples, and an easy to query documentation. We need linking between currently distributed information.
Technical Skills
It would be an advantage to be familiar with Java and JavaDoc, Markdown, LaTeX, and Wikipedia.
Link
Potential Mentors
@draeger
@niko-rodrigue
Contact
[email protected]
The text was updated successfully, but these errors were encountered: