Technical documentation is a generic term for the classes of

information Information is an abstract concept that refers to that which has the power to inform. At the most fundamental level information pertains to the interpretation of that which may be sensed. Any natural process that is not completely random, ...

created to describe (in

technical language Jargon is the specialized terminology associated with a particular field or area of activity. Jargon is normally employed in a particular communicative context and may not be well understood outside that context. The context is usually a particu ...

) the use, functionality or architecture of a product, system or service.

Classes of technical documentation

Classes of technical documentation may include: *

patent A patent is a type of intellectual property that gives its owner the legal right to exclude others from making, using, or selling an invention for a limited period of time in exchange for publishing an sufficiency of disclosure, enabling disclo ...

s *

specification A specification often refers to a set of documented requirements to be satisfied by a material, design, product, or service. A specification is often a type of technical standard. There are different types of technical or engineering specificat ...

s of item or of components/materials * data sheets of item or of components/materials *

test method A test method is a method for a test in science or engineering, such as a physical test, chemical test, or statistical test. It is a definitive procedure that produces a test result. In order to ensure accurate and relevant test results, a test ...

s *

manufacturing Manufacturing is the creation or production of goods with the help of equipment, labor, machines, tools, and chemical or biological processing or formulation. It is the essence of secondary sector of the economy. The term may refer to a ...

standards *

system requirements To be used efficiently, all computer software needs certain hardware components or other software resources to be present on a computer. These prerequisites are known as (computer) system requirements and are often used as a guideline as opposed ...

* system architecture * system design documents and data including those necessary for the system development, testing, manufacturing, operation and maintenance

Standardizing technical documentation

Historically, most classes of technical documentation lacked universal conformity (standards) for format, content and structure. Standards are being developed to redress this through bodies such as the

International Organization for Standardization The International Organization for Standardization (ISO ) is an international standard development organization composed of representatives from the national standards organizations of member countries. Membership requirements are given in Ar ...

(ISO), which has published standards relating to rules for preparation of user guides, manuals, product specifications, etc. for technical product documentation. These standards are covered by ICS 01.110. Technical product documentation not covered by ICS 01.110 are listed in the subsection below.

Discipline-specific

* ISO 15787 * ISO 3098 * ISO 10209 *

ISO 2162 ISO is the most common abbreviation for the International Organization for Standardization. ISO or Iso may also refer to: Business and finance * Iso (supermarket), a chain of Danish supermarkets incorporated into the SuperBest chain in 2007 * I ...

* ISO 5457 *ISO 6433ISO6433

EU Medical Device Regulation

A technical documentation is also required for medical devices following EU medical device regulation. Annex II, Technical documentation, and Annex III, Technical documentation on post-market surveillance, of the regulation describe the content of a technical documentation for a

medical device A medical device is any device intended to be used for medical purposes. Significant potential for hazards are inherent when using a device for medical purposes and thus medical devices must be proved safe and effective with reasonable assur ...

. This includes e.g. information on the device specification, labelling and instructions, design and manufacture, safety and performance requirements, risk management, and the validatain and verfification of the device, including the clinical evaluation; and also information from

postmarketing surveillance Postmarketing surveillance (PMS), also known as post market surveillance, is the practice of monitoring the safety of a pharmaceutical drug or medical device after it has been released on the market and is an important part of the science of pharmac ...

Formats for source data

* Darwin Information Typing Architecture (DITA) *

DocBook DocBook is a semantic markup language for technical documentation. It was originally intended for writing technical documents related to computer hardware and software, but it can be used for any other sort of documentation. As a semantic languag ...

* S1000D * reStructuredText

Documentation architecture and typing

Some documentation systems are concerned with the overall ''types'' or ''forms'' of documentation that constitute a documentation set, as well as (or rather than) how the documentation is produced, published or formatted. For example, the Diátaxis framework (which is mostly used in the field of software documentation ) posits four distinct documentation forms, corresponding to four different user needs: ''tutorials'', ''how-to guides'', ''reference'' and ''explanation''. By contrast, DITA asserts five different "topic types": ''Task'', ''Concept'', ''Reference'', ''Glossary Entry'', and ''Troubleshooting'', while RedHat's Modular Documentation system uses three "modules": ''Concept'', ''Procedure'' and ''Reference''.

Citations

{{DEFAULTSORT:Technical Documentation Documents Technical communication