User experience and compatibility in documentation standards. Summary

Existing guidelines for documentation of scientific computer programs or data libraries are reviewed, and the essential elements for facilitating exchange of the software are outlined. Selected case studies are made in which accepted standards were followed from the programming stage through documentation, and an analysis of user experience.