World Library  
Flag as Inappropriate
Email this Article


Article Id: WHEBN0000164430
Reproduction Date:

Title: Documentation  
Author: World Heritage Encyclopedia
Language: English
Subject: Reserved IP addresses, Specification (technical standard), Martin Documentation, Software documentation, Library and information science
Collection: Information Science, Technical Communication
Publisher: World Heritage Encyclopedia


The multi-volume user guide to a 1975 programming language called CB UNIX

Documentation is a set of documents provided on paper, or online, or on digital or analog media, such as audio tape or CDs. Examples are user guides, white papers, on-line help, quick-reference guides. It is becoming less common to see paper (hard-copy) documentation. Documentation is distributed via websites, software products, and other on-line applications.

Professionals educated in this field are termed documentalists. This field changed its name to information science in 1968, but some uses of the term documentation still exists and there have been efforts to reintroduce the term documentation as a field of study.


  • Principles for producing documentation 1
    • Guidelines 1.1
    • Procedures and techniques 1.2
  • Producing documentation 2
    • Specializing documentation 2.1
    • Indexing 2.2
  • Documentation in computer science 3
    • Tools for documenting software 3.1
  • Documentation in criminal justice 4
  • Notes 5
  • See also 6
  • External links 7

Principles for producing documentation

While associated ISO standards are not easily available publicly, a guide from other sources for this topic may serve the purpose. [1], [2],.[3] David Berger has provided several principles of document writing, regarding the terms used, procedure numbering and even lengths of sentences, etc.[4]


The following is a list of guides dealing with each specific field and type:

Procedures and techniques

The procedures of documentation vary from one sector, or one type, to another. In general, these may involve document drafting, formatting, submitting, reviewing, approving, distributing, reposting and tracking, etc., and are convened by associated SOPs in a regulatory industry. Documentation should be easy to read and understand. If it's too long and too wordy, it may be misunderstand or ignored. Clear, Short, Familiar words should be used to a maximum of 15 words to a sentence. Only gender hyper neutral word should be used and cultural biases should be avoided. Procedures should be numbered when they are to be performed. [11], [12], [13],.[14]

Producing documentation

Technical writers and corporate communicators are professionals whose field and work is documentation. Ideally, technical writers have a background in both the subject matter and also in writing and managing content (information architecture). Technical writers more commonly collaborate with subject matter experts (SMEs), such as engineers, medical professionals, or other types of clients to define and then create content (documentation) that meets the user's needs. Corporate communications includes other types of written documentation that is required for most companies.

Specializing documentation

  • Marketing Communications (MarCom): MarCom writers endeavor to convey the company's value proposition through a variety of print, electronic, and social media. This area of corporate writing is often engaged in responding to proposals.
  • Technical Communication (TechCom): Technical writers document a company's project or service. Technical publication include user guides, installation manuals, and troubleshooting/repair/replace procedures.
  • Legal Writing: This type of documentation is often prepared by attorneys or paralegals who could be in private practice or retained as corporate council.
  • Compliance documentation: This type of documentation codifies Standard Operating Procedures (SOPs), for any regulatory compliance needs, as for safety approval, taxation, financing, technical approval, etc.


Documentation in computer science

The following are typical software documentation types

  • Request for Proposal (RFP)
  • Requirements/ Statement of work/ Scope of Work (SOW)
  • Software Design and Functional Specification
  • System Design and Functional Specifications
  • Change Management, Error and Enhancement Tracking
  • User Acceptance Testing

The following are typical hardware and service documentation types

Documentation include such as feasibility report, technical documentation, operational documentation, log book, etc.

Tools for documenting software

There are many types of software and applications used to create documentation.


A common type of software document written by software engineers in the simulation industry is the SDF. When developing software for a simulator, which can range from embedded avionics devices to 3D terrain databases by way of full motion control systems, the engineer keeps a notebook detailing the development "the build" of the project or module. The document can be a wiki page, MS word document or other environment. They should contain a requirements section, an interface section to detail the communication interface of the software. Often a notes section is used to detail the proof of concept, and then track errors and enhancements. Finally, a testing section to document how the software was tested. This documents conformance to the client's requirements. The result is a detailed description of how the software is designed, how to build and install the software on the target device, and any known defects and work-arounds. This build document enables future developers and maintainers to come up to speed on the software in a timely manner, and also provides a roadmap to modifying code or searching for bugs.


These software tools can automatically collect data of your network equipment. The data could be for inventory and for configuration information. The ITIL Library requests to create such a database as a basis for all information for the IT responsible. It's also the basis for IT documentation.

Documentation in criminal justice

"Documentation" is the preferred term for the process of populating criminal databases. Examples include the National Counter-terrorism Center's Terrorist Identities Datamart Environment ("TIDE"), sex offender registries, and gang databases.[15]


  1. ^ N/A (2003). "Guide to Documentation" (PDF). 
  2. ^ CGRP. "A Guide to Documentation Styles" (PDF). Retrieved 12 June 2009. 
  3. ^ N/A. "A guide to MLA documentation" (PDF). Retrieved 12 June 2009. 
  4. ^ Berger, David. "Procedures and Documentation" (PDF). Retrieved 15 June 2009. 
  5. ^ Springhouse. Complete Guide to Documentation. Retrieved 12 June 2009. 
  6. ^ Tampere University of Technology. "Thesis Writing at the Tampere University of Technology" (PDF). Retrieved 12 June 2009. 
  7. ^ Faculty of Veterinary Medicine, University of Prince Edward Island. "A Guide for the Writing of Graduate Theses" (PDF). Retrieved 12 June 2009. 
  8. ^ University of Waikato. "Writing and Submitting a Dissertation or Thesis at the University of Waikato" (PDF). Retrieved 12 June 2009. 
  9. ^  
  10. ^  
  11. ^ Cropper, Mark; Tony Dibbens (2002). "GAIA-RVS Documentation Procedures" (PDF). Retrieved 15 June 2009. 
  12. ^ N/A. "GLNPO's Quality System Documentation Review Procedures and Tracking" (PDF). Retrieved 15 June 2009. 
  13. ^ UK Data Archive (2009). "Data Services Process Guides: Documentation Processing Procedures" (PDF). Retrieved 15 June 2009. 
  14. ^ UK Data Archive. "Data Services Process Guides: Documentation Processing Techniques" (PDF). Retrieved 15 June 2009. 
  15. ^ Rader Brown, Rebecca (2009). "The Gang's All Here: Evaluating the Need for a National Gang Database". Columbia Journal of Law and Social Problems 42: 293–333. 

See also

External links

  • IEEE Professional Communication Society
  • Documentation Definition by The Linux Information Project (LINFO)
  • Information & Documentation List of selected tools
  • Library of articles on documentation: Technical writing and documentation articles
This article was sourced from Creative Commons Attribution-ShareAlike License; additional terms may apply. World Heritage Encyclopedia content is assembled from numerous content providers, Open Access Publishing, and in compliance with The Fair Access to Science and Technology Research Act (FASTR), Wikimedia Foundation, Inc., Public Library of Science, The Encyclopedia of Life, Open Book Publishers (OBP), PubMed, U.S. National Library of Medicine, National Center for Biotechnology Information, U.S. National Library of Medicine, National Institutes of Health (NIH), U.S. Department of Health & Human Services, and, which sources content from all federal, state, local, tribal, and territorial government publication portals (.gov, .mil, .edu). Funding for and content contributors is made possible from the U.S. Congress, E-Government Act of 2002.
Crowd sourced content that is contributed to World Heritage Encyclopedia is peer reviewed and edited by our editorial staff to ensure quality scholarly research articles.
By using this site, you agree to the Terms of Use and Privacy Policy. World Heritage Encyclopedia™ is a registered trademark of the World Public Library Association, a non-profit organization.

Copyright © World Library Foundation. All rights reserved. eBooks from Project Gutenberg are sponsored by the World Library Foundation,
a 501c(4) Member's Support Non-Profit Organization, and is NOT affiliated with any governmental agency or department.