Write-only documentation

Write-only documentation (WOD) is a tongue-in-cheek term for documentation that is written to satisfy a process but never read subsequent to its writing.

Derogatory term

While write-only documentation may have begun as a derogatory term assigned by technical writers/programmers to documentation that had no other use than to be a required text to meet contractual obligations, the term is in use as a general term for documentation that is seen to be a waste of effort.[1]

Passing comments

Most online references to write-only documentation are made in passing when explaining or writing about some other subject. For example, the term is used in passing when building the case for write-only memory, the subject of an April Fool's Day joke in 1973 from engineers at integrated circuit manufacturer Signetics,[2] in discussing a community project,[3] when discussing accountability in running software building projects,[1] and referring to a project as potential to degenerate into write-only documentation.[4]

Overall use of the term in language

While the term "write-only documentation" has been in use for several years (it can be determined that it was in use in 1995),[5] it is unclear as to where it started to gain traction and what led to its general use in software projects/documentation projects.

See also

References

  1. 1 2 http://www.sphereofinfluence.com/roi.htm
  2. http://www.wyrdology.com/festivals/april-fools-day/wom.html
  3. http://www.krysalis.org/cgi-bin/krywiki.pl?CoPDoC
  4. http://publica.fraunhofer.de/eprints/N-39469.pdf
  5. "Learning-Org Dec 1995: Learning Histories LO4315". www.theworld.com.
This article is issued from Wikipedia. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.