%0 Conference Paper
%A Pospelov, Gennady
%T An easy way to create a website for scientific software project
%M FZJ-2018-03665
%D 2018
%X 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.
%B SINE2020 WP10 annual meeting on neutron data analysis software
%C 6 Jun 2018 - 8 Jun 2018, Soragna (Italy)
Y2 6 Jun 2018 - 8 Jun 2018
M2 Soragna, Italy
%F PUB:(DE-HGF)6
%9 Conference Presentation
%U https://juser.fz-juelich.de/record/848429