This title appears in the Scientific Report :
2018
An easy way to create a website for scientific software project
An easy way to create a website for scientific software project
No one likes creating documentation or investing time in a good looking web site, but everyone enjoys the benefits that come from having appropriate documentation and professionally looking project pages.A big software development team is not limited to the people who actually write and test the cod...
Saved in:
Personal Name(s): | Pospelov, Gennady (Corresponding author) |
---|---|
Contributing Institute: |
Streumethoden; JCNS-2 Neutronenstreuung; JCNS-1 JCNS-FRM-II; JCNS-FRM-II |
Imprint: |
2018
|
Conference: | SINE2020 WP10 annual meeting on neutron data analysis software, Soragna (Italy), 2018-06-06 - 2018-06-08 |
Document Type: |
Conference Presentation |
Research Program: |
Jülich Centre for Neutron Research (JCNS) FRM II / MLZ |
Subject (ZB): | |
Publikationsportal JuSER |
No one likes creating documentation or investing time in a good looking web site, but everyone enjoys the benefits that come from having appropriate documentation and professionally looking project pages.A big software development team is not limited to the people who actually write and test the code. There are technical writers, marketting specialists, web designers and many more.In scientific software development we don't have such a luxury and have to find a way to createand maintain the online user documentation using only very limited resources.In the BornAgain team we are writing documentation using 'markdown' and generate static htmlof the web site using the Hugo static site generator and the Bootstrap front-end component library.Developers are modifying site content and updating the documentation by modifying markdown files and providing pull requests to the web site repository.The generation of the web site html and the update of the hosting service is going on behind the scenes thanks toGitHub based continuous integration magic, Hugo and the documentation theme developed in our group.We advertise our Hugo based documenting workflow and our dedicated documentation themeas a tool to create modern, good looking, responsive web sites for documenting scientific software projects. |