{"id":36121,"date":"2019-11-21T14:31:15","date_gmt":"2019-11-21T10:31:15","guid":{"rendered":"https:\/\/www.msp360.com\/resources\/?p=36121"},"modified":"2023-12-13T13:40:10","modified_gmt":"2023-12-13T09:40:10","slug":"guide-to-msp-internal-documentation-principles-and-practices","status":"publish","type":"post","link":"https:\/\/www.msp360.com\/resources\/blog\/guide-to-msp-internal-documentation-principles-and-practices\/","title":{"rendered":"Guide to MSP Internal Documentation: Principles and Practices"},"content":{"rendered":"<p>Clear internal documentation helps managed service providers to offer a consistent level of support to their clients. It is a baseline for team education and <a href=\"https:\/\/www.msp360.com\/resources\/blog\/msp-employees-onboarding\/\">new-employee onboarding<\/a>. It also helps to ensure the same high standards across your company.<!--more--><\/p>\n<blockquote><p>To learn all the baseline principles of creating <a href=\"https:\/\/www.msp360.com\/resources\/blog\/document-management-software-for-msps\/\">MSP documentation<\/a> you can refer to our <a href=\"https:\/\/www.msp360.com\/resources\/blog\/guide-to-creating-msp-documentation\/\" target=\"_blank\" rel=\"noopener noreferrer\">guide<\/a>.<\/p><\/blockquote>\n<p>Following is an overview of the benefits and principles of internal documentation, and a checklist for the documents that every managed service provider should have for this purpose.<\/p>\n<h2>Why Do You Need Internal Documentation?<\/h2>\n<p>Clear and concise internal documentation allows your company to onboard new team members faster, ensure a solid <a href=\"https:\/\/www.msp360.com\/resources\/blog\/msp-knowledge-management\/\">MSP knowledge management<\/a> process, and resolve problems more efficiently. All of this adds up to a more consistent and reliable <a href=\"https:\/\/www.msp360.com\/resources\/blog\/msp-help-desk\/\">support process<\/a> for your customers, no matter which technicians are providing the support or how long they have worked at your company.<\/p>\n<h2>Principles of Internal Documentation<\/h2>\n<p>Following a few standard principles will help maximize the effectiveness of internal documentation.<\/p>\n<h3>All Support Technicians Should Be Trained in Documentation<\/h3>\n<p>Your technicians should not be permitted to begin supporting end-users without going through some sort of internal, document-based training. Moreover, support personnel should be continually retrained throughout their employment, and all employees should have an opportunity to assist with documentation development.<\/p>\n<ul>\n<li>Documentation should be up-to-date. All of your technicians should be trained with current, up-to-date documentation. As the technology landscape changes, your documentation must change with it.<\/li>\n<li><a href=\"https:\/\/www.msp360.com\/resources\/blog\/on-training-employees-is-it-worth-the-risk\/\">Training<\/a> should be on-going. Technicians shouldn't stop document-based training after they are on-boarded. New training should be scheduled regularly so that everyone is on the same page.<\/li>\n<li>Technicians should help you with writing documentation. Sometimes, the best way to learn about something is to dig in and do research. Other people learn best by teaching others. Both of these concepts can be leveraged by having service technicians assist in documentation development.<\/li>\n<\/ul>\n<p><span class=\"further-reading \">Further reading<\/span> <a href=\"https:\/\/www.msp360.com\/resources\/blog\/msp-employees-engagement\/\">How Your Employees Can Contribute to Your MSP Business<\/a><\/p>\n<p>Training your technicians in written internal documentation helps to offer the best support possible to end-users. It also keeps resolution times short. Internally-developed documentation should be written specifically for your MSP company, not any type of MSP.<\/p>\n<div class=\"call-to-action\">\n<div class=\"call-to-action__left\" style=\"width: 30%;\">\n<p><img decoding=\"async\" class=\"aligncenter\" src=\"https:\/\/www.msp360.com\/resources\/wp-content\/uploads\/2020\/05\/msp-documentation-guide-in-text.png\" alt=\"WP icon\" \/><\/p>\n<\/div>\n<div class=\"call-to-action__right\" style=\"width: 70%;\">\n<div class=\"call-to-action__title\">MSP Documentation Guide<\/div>\n<div class=\"call-to-action__text\">\n<p>Learn how to create the basic types of documentation used by MSPs, and find best practices for properly documenting your processes.<\/p>\n<\/div>\n<!--HubSpot Call-to-Action Code --><span class=\"hs-cta-wrapper hs-cta-deferred\" id=\"hs-cta-wrapper-4dcc01d3-762c-49a6-a989-b8d77f8e6450\" data-portal=\"5442029\" data-id=\"4dcc01d3-762c-49a6-a989-b8d77f8e6450\"><span class=\"hs-cta-node hs-cta-4dcc01d3-762c-49a6-a989-b8d77f8e6450\" id=\"hs-cta-4dcc01d3-762c-49a6-a989-b8d77f8e6450\"><!--[if lte IE 8]><div id=\"hs-cta-ie-element\"><\/div><![endif]--><a href=\"https:\/\/cta-redirect.hubspot.com\/cta\/redirect\/5442029\/4dcc01d3-762c-49a6-a989-b8d77f8e6450\" target=\"_blank\" rel=\"noopener\"><img decoding=\"async\" class=\"hs-cta-img\" id=\"hs-cta-img-4dcc01d3-762c-49a6-a989-b8d77f8e6450\" style=\"border-width:0px;\" src=\"https:\/\/no-cache.hubspot.com\/cta\/default\/5442029\/4dcc01d3-762c-49a6-a989-b8d77f8e6450.png\" alt=\"CTA\"><\/a><\/span><\/span><!-- end HubSpot Call-to-Action Code -->\n<\/div>\n<\/div>\n<h2>Documentation Should Be Kept Current<\/h2>\n<p>It's vitally important to keep all of your documentation up-to-date with current standards, technology, and procedures you use. Using expired documents with new staff will impede your training and reduce the quality of service that you provide to clients.<\/p>\n<ul>\n<li>Technology changes every day. Documentation needs to keep up with changes. When inaccuracies are discovered, documentation should be immediately updated for relevance, or removed from rotation. A plan should be put in place for handling documentation that is discovered to be out-of-date.<\/li>\n<li>Documentation should be reviewed on a regular schedule. Your plan for keeping documentation up-to-date should include a schedule for reviewing current documentation on a regular basis. These reviews will help guarantee that documentation never becomes too outdated. The frequency of these reviews depends on the amount of documentation you are dealing with.<\/li>\n<li>Older documentation should be kept for reference. Although documentation needs to be updated frequently, it\u2019s a good idea to be able to reference earlier copies. This will help paint a picture of initial setups and procedures when troubleshooting issues with expired equipment.<\/li>\n<\/ul>\n<p>Keeping documentation accurate can seem tedious and unnecessary at times, but it comes in handy when training new hires and troubleshooting issues.<\/p>\n<h2>Documentation Should Be Readable and Easy to Understand<\/h2>\n<p>One of the most common mistakes in writing any kind of content is not thinking about the reader. While creating a piece of writing, first consider who will read it, and tailor the content accordingly. For example, if you are writing for experienced technicians, you can skip a lot of background or basic information. But that is not the case if you are writing for entry-level personnel.<\/p>\n<p>Documentation that isn\u2019t easy to understand \u2014 or that is overly dense \u2014 will be ignored.<\/p>\n<ul>\n<li>Documentation must be technical. Written documentation must be effective in addressing technical issues and helping to find solutions. Well-written documentation helps technicians arrive at solutions quickly and efficiently.<\/li>\n<li>Documentation must be usable by even the most novice of technicians. While it is important to keep documentation technical, it won\u2019t be effective if it isn\u2019t usable by all of your technicians. The easiest way to do this is to have all of your documentation proof-read by someone who only has a base level of technical skill.<\/li>\n<li>Think about implementation. You can create a technical masterpiece, but if your procedures for certain clients or situations require a different approach, all that effort is for naught. Documentation is only good as long as it applies to the situations that it is needed for.<\/li>\n<li>Don\u2019t try to create a map of everything. A passionate and knowledgeable person, while creating internal documents and procedures for the first time, might fall into the trap of overstructurization. This is a situation where you try to create a procedure for everything \u2014 including things that aren\u2019t relevant. To avoid this, plan the list of your documentation and discuss it in detail with your team. They will help to define the missing spots as well as over planned.<\/li>\n<\/ul>\n<p>Internal documentation must be written in a way that brings solutions to your end-users and is readable by anyone who may need it. If it doesn\u2019t meet either of these standards, your documentation needs to be reviewed and handled appropriately.<\/p>\n<h2>Necessary Documents Checklist<\/h2>\n<p id=\"last\">There\u2019s no one list of documentation items that applies to all MSPs, but there are basic documents, that <b>will <\/b>be helpful for virtually every managed IT team. Here is a list:<\/p>\n<div id=\"slidebox\"><a class=\"close\">\u00a0<\/a><!--HubSpot Call-to-Action Code --><span class=\"hs-cta-wrapper hs-cta-deferred\" id=\"hs-cta-wrapper-7741eb26-16ea-45c4-9c7f-29ec7e10ad63\" data-portal=\"5442029\" data-id=\"7741eb26-16ea-45c4-9c7f-29ec7e10ad63\"><span class=\"hs-cta-node hs-cta-7741eb26-16ea-45c4-9c7f-29ec7e10ad63\" id=\"hs-cta-7741eb26-16ea-45c4-9c7f-29ec7e10ad63\"><!--[if lte IE 8]><div id=\"hs-cta-ie-element\"><\/div><![endif]--><a href=\"https:\/\/cta-redirect.hubspot.com\/cta\/redirect\/5442029\/7741eb26-16ea-45c4-9c7f-29ec7e10ad63\" target=\"_blank\" rel=\"noopener\"><img decoding=\"async\" class=\"hs-cta-img\" id=\"hs-cta-img-7741eb26-16ea-45c4-9c7f-29ec7e10ad63\" style=\"border-width:0px;\" src=\"https:\/\/no-cache.hubspot.com\/cta\/default\/5442029\/7741eb26-16ea-45c4-9c7f-29ec7e10ad63.png\" alt=\"CTA\"><\/a><\/span><\/span><!-- end HubSpot Call-to-Action Code --><\/div>\n<ul>\n<li><b>Standards of Procedures <\/b>- All technicians should have a baseline of how to follow every project and trouble ticket. Multiple standards of procedures documents can be prepared for each situation that they would apply to.<\/li>\n<li><b>Technical Reference Guide <\/b>- Technicians speak in a language of their own. All employees must have an understanding of the terminology being used within the organization. A technical reference guide is a glossary of terms that all staff should understand.<\/li>\n<li><b>Onboarding Plan <\/b>- New employees shouldn\u2019t be thrown in unprepared. Training all new staff with the same plan will guarantee cohesion across your group. Better prepared staff means better support for end-users.<\/li>\n<\/ul>\n<p><span class=\"further-reading \">Further reading<\/span> <a href=\"https:\/\/www.msp360.com\/resources\/blog\/technician-onboarding\/\">New MSP Tech Onboarding<\/a><\/p>\n<ul>\n<li><b>Role Overviews - <\/b>For most managed service providers, there are multiple different positions for technicians depending on skill level and roles within the company. Each role should be defined in written documents.<\/li>\n<li><b>Code of Conduct \u00a0<\/b>- The code of conduct should help to prevent legal issues. It\u2019s typically written together with an attorney or, if you have a well-established team, by your human resources specialist.<\/li>\n<\/ul>\n<h2>Conclusion<\/h2>\n<p>Clear and concise internal documentation helps to ensure that your team is trained and knowledgeable.<\/p>\n<p>Keep your documents in one place, write them in a way that makes them easy to understand for anyone within a team, and review them regularly. In turn, you will achieve a rise in the efficiency of your business processes.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Clear internal documentation helps managed service providers to offer a consistent level of support to their clients. It is a baseline for team education and new-employee onboarding. It also helps to ensure the same high standards across your company.<\/p>\n","protected":false},"author":46,"featured_media":44378,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[889,878],"tags":[913],"class_list":["post-36121","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-msp-business-guides","category-msp-university","tag-guide-to-creating-msp-documentation"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/posts\/36121","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/users\/46"}],"replies":[{"embeddable":true,"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/comments?post=36121"}],"version-history":[{"count":1,"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/posts\/36121\/revisions"}],"predecessor-version":[{"id":56923,"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/posts\/36121\/revisions\/56923"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/media\/44378"}],"wp:attachment":[{"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/media?parent=36121"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/categories?post=36121"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/tags?post=36121"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}