Content Documentation

This section looks at practical ways to build a content documentation system for managing content effectively in your business.

Content Documentation

Content Documentation

This section looks at practical ways to build a content documentation system for managing content effectively in your business.

Content Documentation - Woman typing on laptop with notes.Documenting systems and processes in areas of your business like content planning, content production, content promotion, and even content management itself allows you not only to better manage these areas but also to improve your results.

In this lesson, we look at the documentation we recommend you develop and store for effectively managing content in your business.

tip

Refer to our content management glossary if you need help understanding some of the terms or concepts described in this section.

***

The Importance Of Documentation

Imagine that your business is run by a team of highly competent, experienced, and knowledgeable people and that there is no need to document anything in your business because everyone is an expert in their area and knows exactly what to do in every situation.

One day, a group of very wealthy investors comes along and expresses an interest in buying your business. They love your products and are very impressed with how things are run.

After introducing them to your wonderful team, they express curiosity about how your business is able to maintain such great standards of quality and consistency and ask about your systems and processes.

You start telling them about the wonderful people in your team and how they know everything.

Your investors then quickly lose interest and withdraw their offer to buy your business.

Why?

Because without documentation, all of the systems and processes of your business exist only inside people’s heads and only for as long as they are physically present and working in your business.

Human skull illustration with a superimposed flowchart diagram.
If this is where all of your business systems and processes live, then yours is a very high-risk business! Source: The Small Business Digital Manager

If someone leaves your business, they take your business systems and processes with them.

Documented systems and processes:

  • Allow your business to improve quality and consistency across all areas.
  • Help to provide better and faster hiring and training across your organization.
  • Lead to higher individual/team productivity and efficiency, and better performance and results.
  • Save time and speed up business growth.
  • Increase the value of your business.

More importantly, having documented systems and processes allows you to work on your business and improve its results by improving its systems and processes.

Content Documentation - Image of 3-ring binders inside a laptop.
Documentation helps you manage your content more effectively.

The section below includes a list of the documentation we recommend your business develop, keep regularly updated, and make accessible to your content team. It will help to improve the quality, consistency, accuracy, and management of all content and content processes in your organization.

Internal Documentation

“Internal documentation is the record of all your company’s internal knowledge, ranging from processes and procedures, best practices, IT and software specs, and much more. Internal documentation is intended for reference by employees to get their work done and standardize performance across the organization.”

Source: Document360

There’s a whole range of internal content your business should create, document, and maintain.

Different types of internal documentation include:

  • Process Documentation –  How-to guides and manuals, best practices, Standard Operating Procedures (SOPs), checklists, etc.
  • Project Documentation – Proposals, plans, strategic documentation, meeting minutes, risk analysis, issue logs, etc.
  • Technical Documentation – Software and IT infrastructure, product specifications and requirements, development processes, etc.
  • HR Documentation – Company policies, onboarding and training materials, employee handbooks, etc.

For more information, see this article: Internal Documentation: How To Create, Tips & Examples

Business Documentation

In addition to having internal documentation such as company policies and documenting procedures and processes describing how work should be done in the business, keeping documentation for the areas below will help your team create accurate content about the company aligned with its business objectives:

Internal Content

  • Business Vision, Mission, Core Values
  • Company History
  • Business Strategy/ Business Plan
  • SWOT Analysis
  • Team Organization Chart
  • Employee/Team Member Profiles And Descriptions (for blog author pages)
  • Support Request Guidelines (to help the Customer Support team)

For more information on additional content you can document about your business, see the Business Basics section.

Web Pages

Check that your site has the following pages (note: some pages are optional) and review their content:

Basic Pages
  • Home Page
  • About Us/Meet The Team
  • Contact Page
  • FAQs
  • Landing Pages (Products and Services)
  • Blog Section
  • Portfolio/Our Work
  • Careers/We’re Hiring
  • Roadmap
Legal Pages
  • Privacy Statement
  • Terms And Conditions
  • Website Disclaimers
  • General Data Protection Regulation (GDPR) Compliance
  • Affiliate Agreement
  • Anti-Spam Policy
  • Compensation Disclosure
  • External Linking Policy
  • Health Disclaimers
  • Refund Policy
  • Media Terms Of Use

Web Content Accessibility

The Web Content Accessibility Guidelines (WCAG) provide technical specifications to improve the accessibility of web content, websites, and web applications across all devices for people with a wide range of disabilities.

Essential Accessibility is an all-in-one accessibility platform that provides accessibility tools, expertise, training, and support, including compliance guides and a downloadable interactive WCAG checklist.

Essential Accessibility WCAG 2.1A and AAA checklists
Use Essential Accessibility’s WCAG 2.1A and AAA interactive checklists to ensure your site and content are compliant with accessibility guidelines.

Access the checklist here: WCAG 2.1 Checklist

Content Planning Documentation

Documenting the content below will help to speed up the process of content creation and ensure content is aligned with business outcomes and expectations:

Content Production Documentation

Documenting the content below will help to speed up the process of content production, improve timely delivery to production deadlines, and help to ensure the quality and consistency of all created content:

Additionally, you can help to improve your team’s efficiency and productivity with documentation covering processes like:

This documentation can include training, guides, guidelines, and tips on:

  • Organizing email inboxes and folders
  • Using applications and sharing content on work tools (e.g. Slack, Zoom, etc.)
  • Uploading files to your website, web server, and cloud storage services.

Most professional tools provide their own documentation and tutorials, so there’s no need to reinvent the wheel. Just create a simple guide with key processes team members should follow, add links to the tool’s documentation, tutorials, and help sections, and include additional resources from the web (e.g. links to helpful articles or videos).

For example, you can use links to resources like the examples shown below to quickly create a simple yet useful guide for team members on how to organize their Gmail inboxes to help them save time and increase their productivity, then provide this guide as part of their orientation and training process:

Content Promotion Documentation

Documenting the content below will help to improve results in areas like lead generation and sales conversions:

  • Marketing Strategy/ Marketing Plan
  • Content Marketing Documentation
  • Content Guidelines:
      • Branding (e.g. see “Positioning Statements” section below)
      • Reciprocal Linking (See Content Distribution)
  • User Documentation
    • Lead Generation (e.g. Guides, PDF reports, etc.)
    • User Education & Training (help users get the most out of your products and services)
    • Distribution Materials (e.g. for wholesalers, retailers, vendors, partners, affiliates, etc.)
  • Marketing Training (Manuals and guides)
  • Creating Marketing Reports

Brand Positioning

Positioning statements help to ensure that your marketing efforts are aligned with your brand.

  • Unique Selling Proposition (USP) – Describes to your target market how you’re different and why they should buy from you.
  • Unique Selling Point– Describes how your company stands out from the competition.
  • Value Proposition – Describes what you are offering to customers for what they are paying and answers the question: Why should customers care that you’re different?

For examples of positioning statements and a free template, go here: Examples Of Positioning Statements (Free Template)

Content Management Documentation

Documenting the areas below will help to improve your content management processes:

Website Documentation

Keeping the information on your website accurate and up-to-date is a form of documentation.

This includes:

  • Company Pages (e.g. About Us)
  • Products & Services Pages
  • FAQs
  • Blog
  • Legal Pages

Legal Pages

Your website needs various legal pages to comply with regulatory requirements (e.g. federal and state laws), and 3rd-party providers (e.g. Google). Legal pages can also protect your business from legal issues, legal threats “takedown” notices, etc.

Legal pages include:

Additionally, depending on the nature of your business, you may also want to consider including some or all of the following pages:

  • Affiliate Agreement (if you sell products or services through an affiliate program.)
  • Anti-Spam Policy
  • Compensation Disclosure
  • External Linking Policy
  • Health Disclaimers (e.g. if your website provides general health or medical content.)
  • Refund Policy (if you run an e-commerce site.)
  • Media Terms Of Use (e.g. if you allow users to download videos or audio files on your site.)
Disclosure Pages – Types

Adding correct disclosure information to your site is essential. For example:

  • No Material Connection – Make your visitors aware that you will not receive compensation for writing the content.
  • Affiliate Links – Make your readers aware that you may be compensated financially if they buy through your affiliate link.
  • Review/Sample Copy – Disclose to your visitors if you have been given a review or sample copy of the product or service you’re reviewing by the author or developer.
  • Sponsored Post – Make your visitors aware that you were compensated in some way to write the post.
  • Third-Party Advertising – Let users know if you’re using online behavioral tracking technology. This is required to comply with the “enhanced notice” the Better Business Bureau has been requiring website publishers to show prominently on their sites since January 1, 2014.

Remember to regularly review and update the information on all of the pages listed above.

Documentation Management Systems

Other types of systems that allow you to manage documentation and your content include:

  • Document Management Systems – A software program designed to help organizations manage, store, and track their electronic and physical documents.
  • Digital Asset Register – Keep a record of all your documentation and digital assets with descriptions, versioning, location, access URLs, software licenses, subscription services, logins, passwords, etc.
  • CMS – Building your online presence using a platform like WordPress functions both as a content management system, and a content documentation system as described in the “Website Documentation” section above. Also, see these different types of Content Management Systems:
    • WCMS – Web Content Management System
    • ECMS – Enterprise Content Management System
    • CCMS – Component Content Management System
    • DAMS – Digital Asset Management System
  • Document Library – A document library is a collection of files, documents, or records that are systematically organized and stored in a digital format.
  • Content Tracking – Create documents and guides to help your team track content production and content performance across your organization, understand and interpret results, and create reports.
  • Documentation Storage – Create documents and guides to help your team access and use various digital storage tools (see below).
  • Content Guidelines For:

Document Storage

Effective content management requires effective ways to collaborate, store, organize, and retrieve documents and content.

Storing documents and content, however, presents its own challenges, as this involves not only working out an efficient way to store, access, and archive digital assets, but also making sure that assets can be worked on collaboratively and be shared, reused, and repurposed across multiple channels.

Some options for storing your documentation and your content include storing your documentation using digital asset management (DAM) software…

Screenshot of Canto - Digital Asset Management Software
You can use Digital Asset Management (DAM) Software…Source: Canto

On a knowledge base platform…

Document 360 - Knowledge Base Platform
Store public or private documentation and content for customers and employees on an online self-service knowledge base. Source: Document360

On a cloud storage solution (e.g. Amazon S3, Dropbox, etc.)…

Screenshot of Amazon AWS buckets
Store your documentation on the cloud using a solution like Amazon’s AWS…

In folders on a shared drive (e.g. Google Drive)…

Screenshot of artwork stored on a Google Drive folder.
Store your documentation inside folders on a shared drive.

In the WordPress Media Library (if you use WordPress as a CMS)…

WordPress Media Library
WordPress Media Library

Or in additional places like cloud-based email, work productivity tools (e.g. Slack channels), and other tools.

Whether your organization chooses to use a digital asset management (DAM) system, online knowledge base software, or set up folders on a shared drive or cloud storage solution will depend on your organization’s digital asset management strategy.

  • Create an organized system of folders to add all the documentation your team members will need to complete their projects and make these sharable and accessible to your team.
  • Use easily identifiable folder naming conventions when storing documentation to ensure that the process remains standardized.
  • Make sure to reference where the folders containing your documentation are located. You can do this using your web browser’s Bookmarks tool and in internal documentation (e.g. create an online guide for your content team for easy access and retrieval of documents).

Document Access

You’ve documented everything in your business and worked out where to store it all…great!

Now, you need to work out how to make all of this documentation easily accessible and retrievable for your team. Otherwise, this will defeat the purpose of creating an efficient system to manage all of your documents and content effectively.

Content Documentation Chart - Documentation, Storage, and Access orbiting around Content Management
Effective content management requires effective documentation, storage, and access systems.

In addition to the storage methods mentioned earlier (e.g. DAM and Knowledge Bases), there are many places to access your documentation, including:

For example, your web browser’s Bookmarking tool is a great way to organize and access links to documentation and useful tools and resources for your content team.

Bookmark Organization
Your web browser’s Bookmarking tool is a great way to organize and access links to documentation, tools, and useful resources.

You can even export and share your bookmarks so everyone in your team can access the documents, tools, and resources they need quickly and easily.

Google Chrome Browser Bookmarks
Use your web browser’s Bookmarking tool to create an organized way for team members to quickly and easily access all the documentation they need to create, promote, and manage content.

Content Documentation – FAQs

Here are frequently asked questions about content documentation:

What is content documentation?

Content documentation refers to the process of creating, storing, managing, and updating all forms of documentation related to a company’s content processes, including text, images, video, and multimedia. This ensures information is easily accessible and can be updated or repurposed efficiently.

Why is content documentation important?

It helps maintain consistency across various content channels, improves collaboration among team members, ensures compliance with legal and regulatory requirements, and serves as a historical record of content strategies and outputs.

What are the key elements of effective content documentation?

Effective content documentation should include a clear purpose, audience identification, structured format, detailed content guidelines, and revision history. These elements ensure that documentation is useful and accessible to all stakeholders involved.

How does a content management system (CMS) support content documentation?

A CMS helps in organizing, controlling, and publishing documentation without requiring technical expertise. Features like version control, access permissions, and integration capabilities make CMS an indispensable tool for content documentation.

What should be included in a content documentation strategy?

The strategy should outline the content lifecycle, roles and responsibilities of the content team, documentation standards, storage and retrieval processes, and tools and technologies used for creating and maintaining documents.

How do I choose the right tools for content documentation?

Select tools based on your specific needs for collaboration, version control, ease of use, scalability, and integration with other systems. Consider the nature of your content and the size of your team to find a suitable solution.

What are some common challenges in content documentation and how can they be addressed?

Common challenges include maintaining up-to-date records, ensuring document accessibility, and managing multiple content formats. Regular audits, training for team members, and leveraging a robust CMS can help address these issues.

Summary

All too often, business knowledge, systems, and processes are stored in the heads of employees and scattered across all the various tools used in the business. There is little documentation and no single source of truth for it.

This leads to valuable time and effort wasted searching for information across all areas of the business, including information required to assist in speeding up areas like content planning, content production, and content promotion.

An effective content documentation system that allows your content team to quickly and easily access all stored documents is essential to effective content management.

Documentation is a massive undertaking, but once started and implemented, it leads to improved results in all areas of the business.

Action Steps

  1. Review this lesson and identify all the different areas of your business that need documentation.
  2. Create a list of all the documented systems and processes each of these business areas needs to operate efficiently and effectively, especially in areas related to content planning, content production, and content promotion.
  3. Develop a plan for organizing, storing, accessing, distributing, and implementing all business documentation.
  4. Begin documenting all systems and processes listed above. This can be as simple as creating bullet-point guides, procedures, and checklists.
  5. Train your team members to use and follow the documentation.
  6. Continually review and improve your documentation.

Resources

  • How To Use Amazon S3 – Video course on using Amazon AWS to store files (e.g. media, documentation, etc.)
  • Content Troubleshooting Guide – Use this guide to help you troubleshoot issues with your content and improve your content management.

References

***

Image: Woman Typing, 3-ring Binders in Laptop

Author: Martin Aranovitch

Martin Aranovitch is a trainer, educator, blog writer, and online publisher. He runs various training websites on digital business, including ContentManagementCourse.com, WPTrainingManual.com, WPMasterclasses.com, and WPCompendium.org. View all posts by Martin Aranovitch