Filter posts by Category Or Tag of the Interest section!

Documentation tips

Monday, 12 September 2022

Before getting into the detail of documentation tips, let's look at the types of documentation. There are several types of documentation that are commonly used in various fields and industries. Some of the most common types of documentation include:


  1. Technical documentation: This type of documentation is used to explain how to use, maintain, or repair a product or system. Technical documentation may include user manuals, installation guides, maintenance manuals, and troubleshooting guides.
  2. Business documentation: This type of documentation is used to record and communicate information related to business processes and operations. For example policies and procedures manuals, business plans, financial statements, and contracts.
  3. Legal documentation: This type of documentation is used to record legal agreements, transactions, and other important information related to legal matters. Examples of legal documentation include contracts, deeds, wills, and patents.
  4. Medical documentation: This type of documentation is used to record medical information and treatment plans for patients. Examples of medical documentation include patient charts, medical histories, and treatment plans.
  5. Educational documentation: This type of documentation is used to record educational achievements and progress. Examples of educational documentation include transcripts, diplomas, and certificates.
  6. Project documentation: This type of documentation is used to record project plans, progress, and outcomes. Examples of project documentation include project plans, project reports, and project timelines.
  7. Marketing documentation: This type of documentation is used to promote products or services. Examples of marketing documentation include brochures, flyers, and product descriptions.


As a tech and business guy, I can only talk about numbers 1,2, and 6 and share my experiences about the mentioned ones. The specific types of documentation that are used in a particular field or industry will depend on the nature of the work being done and the information that needs to be communicated. I personally love organizing and documenting everything! Here are some documentation tips that can help you create clear, effective, and user-friendly documentation:


  1. Know your audience: Before you start creating your documentation, it's important to identify your target audience and their level of expertise. This will help you choose the appropriate tone, level of detail, and language for your documentation.
  2. Use clear and concise language: Use simple and direct language to ensure that your documentation is easy to understand. Avoid using jargon, technical terms, and complex sentences.
  3. Organize your information: Organize your information into sections or chapters and use headings and subheadings to make it easy to navigate. Consider using bullet points or numbered lists to break down complex information into more manageable chunks.
  4. Include visuals: Visual aids such as diagrams, screenshots, and videos can help illustrate your points and make your documentation more engaging and memorable.
  5. Test your documentation: Make sure to test your documentation with real users to ensure that it is clear, easy to follow, and provides the information they need.
  6. Keep it up to date: Documentation should be regularly reviewed and updated to ensure that it reflects any changes to the product or service it is describing.
  7. Make it accessible: Ensure that your documentation is accessible to all users, including those with disabilities. Consider using tools such as screen readers and alternative text for images to make your documentation more inclusive.

As I mentioned, I love organizing. I personally use pictures, charts, tables, and graphical stuff as much as I can because it’s really boring reading dry documentation. In order to be more organized while documenting here are some additional tips for organizing your information when creating documentation:


  1. Use a logical structure: Organize your information in a way that makes sense to your audience. For example, you might choose to organize your documentation chronologically, by topic, or by function.
  2. Use headings and subheadings: Use clear, descriptive headings and subheadings to break up your documentation into manageable sections. This makes it easier for readers to find the information they need quickly.
  3. Use bullet points and numbered lists: Use bullet points or numbered lists to break down complex information into more manageable chunks. This makes it easier for readers to scan your documentation and find the information they need.
  4. Use tables and charts: Use tables and charts to organize information that is best presented in a visual format, such as data or comparisons. This makes it easier for readers to understand complex information at a glance.
  5. Use a consistent formatting style: Use a consistent formatting style throughout your documentation, including font size and style, headings, subheadings, and bullet points. This makes your documentation look professional and easier to read.
  6. Use white space: Use white space to break up your text and make your documentation look less cluttered. This makes it easier for readers to focus on the information that is most important.


In a nutshell, documentation is an important tool for improving communication, increasing efficiency, and ensuring high-quality work. It helps to facilitate collaboration, reduce errors, and provide a clear record of progress and accountability. I know that it’s really cumbersome to create documentation, especially creating an official one but it works! If you have experience working on a project without any documentation, you totally understand what I mean!  

Category: Miscellaneous

comments powered by Disqus