Top considerations for creating bioinformatics software documentation

Brief Bioinform. 2018 Jul 20;19(4):693-699. doi: 10.1093/bib/bbw134.

Abstract

Investing in documenting your bioinformatics software well can increase its impact and save your time. To maximize the effectiveness of your documentation, we suggest following a few guidelines we propose here. We recommend providing multiple avenues for users to use your research software, including a navigable HTML interface with a quick start, useful help messages with detailed explanation and thorough examples for each feature of your software. By following these guidelines, you can assure that your hard work maximally benefits yourself and others.

Publication types

  • Research Support, Non-U.S. Gov't

MeSH terms

  • Computational Biology / methods*
  • Documentation / standards*
  • Guidelines as Topic*
  • Humans
  • Software / standards*