Documentation

Documentation

Documentation is a term used in several different ways. Generally, documentation (to document) refers to the process of providing evidence. Modules of Documentation are Helpful. The most common meanings are:

  • the process of documenting knowledge (or rather knowledge claims) (as done in, for example, scientific journals).
  • the writing of software documentation (or other kinds of product documentation)
  • a synonym for the term document
  • a synonym for the term bibliography
  • a field of study and a profession founded by Paul Otlet (1868-1944) and Henri La Fontaine (1854-1943), which is also termed documentation science. 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.


Classical documentation is a set of documents printed on paper. .

Contents

Documentation composure

Documentation may include

  • written information for any read, projection or technical performing,
  • data media of any format and for any reproduction,
  • other content.

Common types of documentation include user guides, white papers, on-line help, quick-reference guides. It is less common to see hard-copy (paper) documentation. Documentation is distributed via websites, software products, and other on-line applications.

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]

Guidelines

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, repositing and tracking, etc., and are convened by associated SOPs in a regulatory industry [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.

Indexing

Further information: Document management system

Documentation in computer science

The following are typical 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 Test and Acceptance (UTA)

Tools for documenting software

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

SOFTWARE DOCUMENTATION FOLDER (SDF)

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.

Documentation in criminal justice

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

Notes

  1. ^ N/A (2003). "Guide to Documentation". http://www.somers.k12.ct.us/common/guide_to_doc.pdf. Retrieved 12 June 2009. [dead link]
  2. ^ CGRP. "A Guide to Documentation Styles". http://www.sfsu.edu/~carp1/pdf/A%20Guide%20to%20Documentation%20Styles.pdf. Retrieved 12 June 2009. 
  3. ^ N/A. "A guide to MLA documentation". http://www.sunyjcc.edu/jamestown/library/pdf/mla.pdf. Retrieved 12 June 2009. [dead link]
  4. ^ Berger, David. "Procedures and Documentation". http://www.maintenanceonline.org/maintenanceonline/content_images/p11%20Trans%20View-20080410-222135.pdf. Retrieved 15 June 2009. 
  5. ^ Springhouse. Complete Guide to Documentation. http://books.google.com/books?id=m1fPFVJIi6gC&pg=PA87&dq=intitle:documentation&lr=&as_drrb_is=b&as_minm_is=1&as_miny_is=2005&as_maxm_is=6&as_maxy_is=2009&as_brr=0#PPP1,M1. Retrieved 12 June 2009. 
  6. ^ Tampere University of Technology. "Thesis Writing at the Tampere University of Technology". http://www.tut.fi/public/english/Guide/thesisguide.pdf. Retrieved 12 June 2009. 
  7. ^ Faculty of Veterinary Medicine, University of Prince Edward Island. "A Guide for the Writing of Graduate Theses". http://www.upei.ca/avc/files/avc/guidetowritingthesis.pdf. Retrieved 12 June 2009. 
  8. ^ University of Waikato. "Writing and Submitting a Dissertation or Thesis at the University of Waikato". http://www.waikato.ac.nz/library/learning/g_thesis.pdf. Retrieved 12 June 2009. 
  9. ^ Journal of Food Science. "Manuscript Submission". http://members.ift.org/IFT/Pubs/JournalofFoodSci/jfsmanuscripts/. Retrieved 12 June 2009. 
  10. ^ Analytical Chemistry. "Information for Authors". http://pubs.acs.org/page/ancham/submission/authors.html. Retrieved 12 June 2009. 
  11. ^ Cropper, Mark; Tony Dibbens (2002). "GAIA-RVS Documentation Procedures". http://www.mssl.ucl.ac.uk/gaia-rvs/document_repository/MSSL_GAIA-RVS_AD_001.01.pdf. Retrieved 15 June 2009. 
  12. ^ N/A. "GLNPO's Quality System Documentation Review Procedures and Tracking". http://www.epa.gov/glnpo/qmp/Appendix%20S/Quality_Doc_Review_Procedures.pdf. Retrieved 15 June 2009. [dead link]
  13. ^ UK Data Archive (2009). "Data Services Process Guides: Documentation Processing Procedures". http://www.esds.ac.uk/news/publications/UKDA_DSS_DocumentationProcessingProcedures.pdf. Retrieved 15 June 2009. 
  14. ^ UK Data Archive (2007). "Data Services Process Guides: Documentation Processing Techniques". http://www.esds.ac.uk/news/publications/UKDADocProcessingTechniques.pdf. Retrieved 15 June 2009. [dead link]
  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


Wikimedia Foundation. 2010.

Игры ⚽ Поможем решить контрольную работу

Look at other dictionaries:

  • DOCUMENTATION — Le progrès de la science étant une œuvre collective, les informations doivent circuler entre les chercheurs d’une manière aussi rapide et complète que possible. Qu’il s’agisse des méthodes expérimentales employées, des observations effectuées,… …   Encyclopédie Universelle

  • documentation — doc‧u‧men‧ta‧tion [ˌdɒkjmənˈteɪʆn, men ǁ ˌdɑːk ] noun [uncountable] 1. documents that are used to prove that something is true or correct, or as a record of something: • He was asked to provide documentation of his personal finances. 2.… …   Financial and business terms

  • Documentation — see «Document» Источник …   Словарь-справочник терминов нормативно-технической документации

  • documentation — I noun annals, authentication, authority, basis, certification, circumstantiation, confirmation, corroboration, data, evidence, evidential record, evidentiary record, exhibit, factual basis, grounds, grounds for belief, medium of proof, proof,… …   Law dictionary

  • documentation — 1754, admonition, from M.L. documentationem (nom. documentio) admonition (see DOCUMENT (Cf. document)). Meaning furnishing with documents or papers is from 1884, probably from DOCUMENT (Cf. document). Meaning collection of informational papers is …   Etymology dictionary

  • documentation — ► NOUN 1) the documents required in the provision of information or evidence. 2) written specifications or instructions …   English terms dictionary

  • documentation — [däk΄yəmən tā′shən, däk΄yəmentā′shən] n. 1. the supplying of documents or supporting references; use of documentary evidence 2. the documents or references thus supplied 3. the collecting, abstracting, and coding of printed or written information …   English World dictionary

  • Documentation — La documentation est l action de sélectionner, de classifier, d utiliser, et de diffuser des documents. Le métier de documentaliste est donc à classifier dans le domaine des services, mais aussi dans le domaine de l éducation avec le métier de… …   Wikipédia en Français

  • documentation — n. 1) to provide documentation for 2) strong; weak documentation * * * [ˌdɒkjʊmen teɪʃ(ə)n] weak documentation strong to provide documentation for …   Combinatory dictionary

  • documentation — doc|u|men|ta|tion [ˌdɔkjumənˈteıʃən, men US ˌda:k ] n 1.) [U] official documents, reports etc that are used to prove that something is true or correct ▪ Applicants must provide supporting documentation . 2.) [U and C] the act of recording… …   Dictionary of contemporary English

Share the article and excerpts

Direct link
… Do a right-click on the link above
and select “Copy Link”