The Duty of Candor in Future Software Documentation
http://www.stc.org/46thConf/postconf/girill.html

Girill, T.R.
STC Proceedings
1999

Abstract:

The STC Code for Communicators requires us 'to communicate technical information truthfully...'. Such truthfulness has two related but distinct aspects, honesty and candor. I have never been asked to falsify technical claims in documentation (honesty), but I have occasionally been asked to withhold true claims about software that, if known to users, would surely affect how they interpret or apply that software (candor). The century ahead will increasingly demand user documentation that is candid as well as honest.