Presentation Open Access

Continuous Documentation for Users, Developers and Maintainers

Frust, Tobias


JSON-LD (schema.org) Export

{
  "inLanguage": {
    "alternateName": "eng", 
    "@type": "Language", 
    "name": "English"
  }, 
  "description": "<p>This talk covers the often neglected and &ldquo;hated&rdquo; aspect of software documentation that is indispensable in a sustainable research software development process. A good, up-to-date and easily accessible software documentation lays the foundation for broader usage and collaboration. Software documentation usually covers three different components: user documentation, instructions how to modify and contribute to the software and a low-level API documentation. When starting developing a new research software, the documentation should be considered from the very beginning. Maintaining an up-to-date software documentation with good coverage in an exascale ready scientific software stack is only achievable, if the contribution process clearly includes a check for documentation adding or updates. This check can only be automated partially and usually requires a manual review process. All contributions must be made with the understanding, that documentation is a key aspect of any contribution. Things get never cleaned up later. Recurrent tasks should be automated wherever possible to reduce the impact of manual errors, e.g. the deployment of software documentation. This talk provides a set of best practices for software documentation in science combined with concrete examples from real-world scientific software solutions.</p>", 
  "license": "https://creativecommons.org/licenses/by/4.0/legalcode", 
  "creator": [
    {
      "affiliation": "Helmholtz-Zentrum Dresden-Rossendorf", 
      "@id": "https://orcid.org/0000-0002-5590-7473", 
      "@type": "Person", 
      "name": "Frust, Tobias"
    }
  ], 
  "url": "https://zenodo.org/record/3247324", 
  "datePublished": "2019-06-17", 
  "@type": "PresentationDigitalDocument", 
  "keywords": [
    "Documentation", 
    "Software", 
    "Best Practices", 
    "Sustainability", 
    "Sustainable", 
    "Version Control"
  ], 
  "@context": "https://schema.org/", 
  "identifier": "https://doi.org/10.5281/zenodo.3247324", 
  "@id": "https://doi.org/10.5281/zenodo.3247324", 
  "workFeatured": {
    "url": "https://pasc19.pasc-conference.org/", 
    "alternateName": "PASC19", 
    "location": "Zurich, Switzerland", 
    "@type": "Event", 
    "name": "Platform for Advanced Scientific Computing Conference 2019"
  }, 
  "name": "Continuous Documentation for Users, Developers and Maintainers"
}
375
53
views
downloads
All versions This version
Views 375375
Downloads 5353
Data volume 106.3 MB106.3 MB
Unique views 362362
Unique downloads 4141

Share

Cite as