Presentation Open Access

Continuous Documentation for Users, Developers and Maintainers

Frust, Tobias


DataCite XML Export

<?xml version='1.0' encoding='utf-8'?>
<resource xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://datacite.org/schema/kernel-4" xsi:schemaLocation="http://datacite.org/schema/kernel-4 http://schema.datacite.org/meta/kernel-4.1/metadata.xsd">
  <identifier identifierType="DOI">10.5281/zenodo.3247324</identifier>
  <creators>
    <creator>
      <creatorName>Frust, Tobias</creatorName>
      <givenName>Tobias</givenName>
      <familyName>Frust</familyName>
      <nameIdentifier nameIdentifierScheme="ORCID" schemeURI="http://orcid.org/">0000-0002-5590-7473</nameIdentifier>
      <affiliation>Helmholtz-Zentrum Dresden-Rossendorf</affiliation>
    </creator>
  </creators>
  <titles>
    <title>Continuous Documentation for Users, Developers and Maintainers</title>
  </titles>
  <publisher>Zenodo</publisher>
  <publicationYear>2019</publicationYear>
  <subjects>
    <subject>Documentation</subject>
    <subject>Software</subject>
    <subject>Best Practices</subject>
    <subject>Sustainability</subject>
    <subject>Sustainable</subject>
    <subject>Version Control</subject>
  </subjects>
  <dates>
    <date dateType="Issued">2019-06-17</date>
  </dates>
  <language>en</language>
  <resourceType resourceTypeGeneral="Text">Presentation</resourceType>
  <alternateIdentifiers>
    <alternateIdentifier alternateIdentifierType="url">https://zenodo.org/record/3247324</alternateIdentifier>
  </alternateIdentifiers>
  <relatedIdentifiers>
    <relatedIdentifier relatedIdentifierType="DOI" relationType="IsVersionOf">10.5281/zenodo.3247323</relatedIdentifier>
  </relatedIdentifiers>
  <rightsList>
    <rights rightsURI="https://creativecommons.org/licenses/by/4.0/legalcode">Creative Commons Attribution 4.0 International</rights>
    <rights rightsURI="info:eu-repo/semantics/openAccess">Open Access</rights>
  </rightsList>
  <descriptions>
    <description descriptionType="Abstract">&lt;p&gt;This talk covers the often neglected and &amp;ldquo;hated&amp;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.&lt;/p&gt;</description>
  </descriptions>
</resource>
373
53
views
downloads
All versions This version
Views 373373
Downloads 5353
Data volume 106.3 MB106.3 MB
Unique views 360360
Unique downloads 4141

Share

Cite as