by Patrik Hermansson

• Abstract
• Chapter 1 - Different types of documentation
  • Technical documentation
  • Descriptive documentation
  • Policy documentation
  • Mix-mode documentation
• Chapter 2 - Why do we need documentation?

Documentation is a loose concept. This document is a try to clarify about what documentation is and how to use it from a technologically point of view. Some (but not all) things to answer:

• Different kind of documentation.
• Why do we need documentation?
• Collaborate or not?
• The importance of updating the documentation.

Let’s dive in …

Examples:

• Code in repository (like GitHub or GitLab).
• Detailed technical documentation of servers, firewalls or similar.
• Electrical schematics.
• Recipe in a cookbook.

Descriptive documentation is usually an overview over something. A more top view on how things are working. Little or no technical information is included. Examples:

• A network schematics over a network or setup with several servers.
• A flow chart describing on how a program or script is working.

Policy documentation differ from the other kind of documents described here because the matter of the document is more abstract than in the others. A policy documentation is more of an ide on how to proceed, whereas the other documents shows more detailed view on how the world are in a model (Descriptive) or down on a detailed level (technical).

This is documentation, usually for project planning, that includes both parts of the technical and parts of the descriptive documentations. This kind of documentation is good for planning new setups and changes in current setup, programs or similar.

This might feel like a silly question and maybe the question should be “Why is documentation so important?”.