Everything about Documentation totally explained
In general terms,
documentation is any communicable material (such as text, video, audio, etc., or combinations thereof) used to explain some attributes of an object, system or procedure. It is often used to mean
engineering documentation or
software documentation, which is usually paper books or
computer readable files (such as
HTML pages) that describe the structure and components, or on the other hand, operation, of a system/product.
A professional whose field and work is more or less exclusively to write documentation is called a
technical writer. Normally, technical writers are trained or have a background in
technical writing, along with some knowledge of the subject(s) they're documenting. Often, though, they collaborate with subject matter experts (SMEs), such as engineers.
Common types of
computer hardware/
software documentation include
online help,
FAQs,
how-tos, and
user guides. The term
RTFM is often used in regard to such documentation, especially to computer hardware and software user guides.
A common type of software document frequently written by software engineers in the simulation industry is the SDF (software documentation folder). While developing the software for a simulator, which can range from embedded avionics devices to 3D terrain databases to full motion control systems, the engineer keeps a notebook detailing the development lifecycle of the project. The notebook can contain a requirements section, an interface section detailing the communication interface of the software, a notes section to detail the proof of concept attempts to track what worked or didn't work in solving certain problems, and a testing section to detail how the software will be tested to prove conformance to the requirements of the contract. The end 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 weaknesses in the design of the software. This document will allow future developers and maintainers of the trainer to come up to speed on the software design in as short a time as possible and have a documented reference when modifying code or searching for bugs.
In some European countries,
documentation in an academic context is an older term, coined by
Paul Otlet, for the field of study now more commonly known as
library science and
information science. Librarians with this specialization are called
documentalists.
Further Information
Get more info on 'Documentation'.
|
External Link Exchanges
Do you know how hard it is to get a link from a large encyclopaedia? Well we're different and will prove it. To get a link from us just add the following HTML to your site on a relevant page:
<a href="http://documentation.totallyexplained.com">Documentation Totally Explained</a>
Then simply click through this link from your web page. Our crawlers will verify your link, extract the title of your web page and instantly add a link back to it. If you like you can remove the words Totally Explained and embed the link in article text.
As long as your link remains in place, we'll keep our link to you right here. Please play fair - our crawlers are watching. Your site must be closely related to this one's topic. Any kind of spamming, dubious practises or removing the link will result in your link from us being dropped and, potentially, your whole site being banned. |
