The Better Scientific Software PSIP site (bssw-psip) is the main landing page that allows users a central portal to access guides, project tracking cards, and recent posts about Productivity and Sustainability Improvement Planning (PSIP).
Through the content available in this portal, the user can explore the purposes and procedures to enable use of the PSIP process for their project.
This application is built using GitHub Pages on top of the suggested Jekyll theme.
The website is currently divided into three sections:
- Main Site: This is the main site/home page, https://bssw-psip.github.io/. The source code can be found at https://github.com/bssw-psip/bssw-psip.github.io.
- Practice Guides: This subsite, https://bssw-psip.github.io/practice-guides/, provides the guides for utilizing PSIP to improve team practices. The source code can be found at https://github.com/bssw-psip/practice-guides.
- Project Tracking Card Catalog: This subsite, https://bssw-psip.github.io/ptc-catalog/catalog/, provides previously developed and example PTCs, for use in tracking improvement progress. The source code can be found at https://github.com/bssw-psip/ptc-catalog.
Because BSSw PSIP is powered through GitHub Pages, there are extensive tutorials in existence on how to build and test sites locally.
See the main GitHub Pages documentation.
NOTE: If you are a developer on a Mac and using Ruby 3, please add the
following line to the Gemfile
before running bundle install
:
gem "webrick"
This is a well-documented workaround to a known bug.
The development of this site was supported by the Exascale Computing Project (17-SC-20-SC), a collaborative effort of the U.S. Department of Energy Office of Science and the National Nuclear Security Administration.