{"id":143585,"date":"2015-07-25T11:00:24","date_gmt":"2015-07-25T15:00:24","guid":{"rendered":"http:\/\/premium.wpmudev.org\/blog\/?p=143585"},"modified":"2022-04-01T00:31:24","modified_gmt":"2022-04-01T00:31:24","slug":"wordpress-instruction-manuals","status":"publish","type":"post","link":"https:\/\/wpmudev.com\/blog\/wordpress-instruction-manuals\/","title":{"rendered":"How to Create User-Friendly WordPress Instruction Manuals for Clients (in 7 Steps)"},"content":{"rendered":"<p>Teaching WordPress to anyone who has never used the platform before can be a huge and daunting task \u2013 especially for clients who want to keep a close eye on everything you do for them.<\/p>\n<p>Nowadays it&#8217;s\u00a0quite common for business owners and other employees to want to understand how their WordPress site works. Thankfully it\u2019s unnecessary for you to invest hours of your own time standing over their shoulder so you can teach them everything one-on-one.<\/p>\n<figure class=\"wp-caption aligncenter\" data-caption=\"true\"><img loading=\"lazy\" decoding=\"async\" class=\"attachment-490x490\" src=\"https:\/\/wpmudev.com\/blog\/wp-content\/uploads\/2015\/07\/instruction-manual.png\" alt=\"Instruction manuals should be the first point of reference for users who are stuck using your products.\" width=\"490\" height=\"312\" \/><figcaption class=\"wp-caption-text\">Instruction manuals should be the first point of reference for users who are stuck using your products.<\/figcaption><\/figure>\n<p>Both you and the client undoubtedly have more important things to do, and besides, having to teach every individual client that you work with would probably drive you nuts. Instead, you can create your own <a href=\"https:\/\/wptrainingmanual.com\/product\/the-complete-wordpress-step-by-step-user-manual\/\" rel=\"noopener\" target=\"_blank\">comprehensive WordPress user manual<\/a> (or even pay someone else to create it for you) so that your clients can have peace of mind knowing that they are in control of their site.<\/p>\n<p>Here some essential tips you should consider in your approach to drafting your first WordPress instruction manual:<\/p>\n<ol>\n<li><a href=\"#overview\">Begin with an Introductory Overview<\/a><\/li>\n<li><a href=\"#sections\">Break up the Main WordPress Components into Sections<\/a><\/li>\n<li><a href=\"#subsections\">Add Subsections to the Main Sections<\/a><\/li>\n<li><a href=\"#visual-steps\">Use a Visual Step-By-Step Process<\/a><\/li>\n<li><a href=\"#descriptive-explanations\">Support the Visuals with Descriptive Explanations<\/a><\/li>\n<li><a href=\"#extras\">Include Helpful Extras<\/a><\/li>\n<li><a href=\"#review\">Get Someone to Review Your Manual<\/a><\/li>\n<\/ol>\n<h2 id=\"overview\">1. Begin with an Introductory Overview<\/h2>\n<p>Before you do anything, you have to really put yourself in the mindset of a complete WordPress beginner \u2013 ideally someone\u00a0who struggles with the technical side of the web. The scope will depend on the types of clients you work with, so\u00a0you may want to spend some time writing down exactly what your client needs from the manual. Asking them is the easiest way to get this information, and then you\u00a0can tailor your manual to the needs of your clients as closely as possible. The more thorough you can be with regard to your specific client base, the more your\u00a0clients will be able to get out of your manual.<\/p>\n<p>A good way to go about easing people into WordPress is to start off with introducing the extreme basics. Try briefly covering topics like:<\/p>\n<ul>\n<li>What WordPress is<\/li>\n<li>What people do with WordPress<\/li>\n<li>Why WordPress is so popular<\/li>\n<li>Why anyone can learn WordPress<\/li>\n<li>What the user will learn about WordPress from the instructional manual<\/li>\n<li>What the user will be able to understand and execute in WordPress upon reviewing the manual<\/li>\n<\/ul>\n<p>Keep it simple. You want to establish the right tone of voice here in order to reassure that your clients\u00a0will be able\u00a0to follow along easily. It may even be more appropriate to tackle this introductory part after you\u2019ve finished drafting out the main part of the content so you\u2019ll be able to provide a better summary of everything here.<\/p>\n<h2 id=\"sections\">2. Break up the Main WordPress Components into Sections<\/h2>\n<p>Proper arrangement of all the content included in your manual is not only essential to avoid confusing the user, but also necessary to cover more detailed points and flow into related sections in a way that makes the most sense. For example, you wouldn\u2019t start with showing users how to publish a post, then move on to talking about comment management, then go back to showing users how to publish pages. Although posts do flow into commenting, keeping all publishing content together would provide a better flow.<\/p>\n<figure class=\"wp-caption aligncenter\" data-caption=\"true\"><img loading=\"lazy\" decoding=\"async\" class=\"attachment-490x490\" src=\"https:\/\/wpmudev.com\/blog\/wp-content\/uploads\/2015\/07\/wp-dashboard.png\" alt=\"Use the WordPress dashboard for inspiration on how to structure your content.\" width=\"490\" height=\"312\" \/><figcaption class=\"wp-caption-text\">Use the WordPress dashboard for inspiration on how to structure your content.<\/figcaption><\/figure>\n<p>Ask yourself, where would the user start? What order of instructions would make the most sense? From here, you can start building an outline of your main sections.<\/p>\n<p>In fact, you can use the order of the sections displayed in the Dashboard Menu as inspiration and adjust it accordingly to what you want to teach your users.<\/p>\n<p>As an example, your main sections might include:<\/p>\n<ul>\n<li>Logging in<\/li>\n<li>The Dashboard<\/li>\n<li>Posts<\/li>\n<li>Pages<\/li>\n<li>Images and Media<\/li>\n<li>Comments<\/li>\n<li>Appearance Features<\/li>\n<li>Plugins<\/li>\n<li>Users<\/li>\n<li>Tools<\/li>\n<li>Settings<\/li>\n<\/ul>\n<p>Could this be improved? Sure it could. Posts and pages are quite similar, so it might make sense to combine the two into one section, although making sure to provide explanations on the difference between posts and pages, and using separate subsections for pages or posts when necessary. But that&#8217;s all up to you.<\/p>\n<p>Alternatively, you might want to even leave out entire sections like Users, Tools, and Settings if you want to just provide the very basics of content publishing and editing for your users. You could also add in more advanced or customizable sections for\u00a0anything pertaining to specific plugins or theme options.<\/p>\n<h2 id=\"subsections\">3. Add Subsections to the Main Sections<\/h2>\n<p>There\u2019s a lot to learn about WordPress, so breaking up your big sections into subsections is the smart thing to do. Some sections will naturally have more subsections than others. For example, Logging in is pretty straightforward, but still requires a few areas to be covered:<\/p>\n<ul>\n<li>Accessing the login page<\/li>\n<li>Logging into your account with your username and password<\/li>\n<li>Retrieving a forgotten username or password<\/li>\n<li>Logging out of your account<\/li>\n<\/ul>\n<p>That\u2019s about as much as you need in terms of the very basics of logging in, and you could even condense it all into one or two subsections if you wanted. In contrast, the main section affiliated with publishing content is likely going to be your biggest section to tackle. It might look something like this:<\/p>\n<ul>\n<li>Posts vs. Pages<\/li>\n<li>Adding a New Post<\/li>\n<li>Adding a New Page<\/li>\n<li>Using the Visual Editor<\/li>\n<li>Using the Text Editor<\/li>\n<li>Adding Images and Media<\/li>\n<li>Adding Links<\/li>\n<li>Formatting Content<\/li>\n<li>Adding Excerpts<\/li>\n<li>Setting Featured Images<\/li>\n<li>Adding Categories to Posts<\/li>\n<li>Adding Tags to Posts<\/li>\n<li>Customizing Parent Pages and Templates<\/li>\n<li>Saving Posts and Pages as Drafts<\/li>\n<li>Submitting Posts and Pages to Pending Review<\/li>\n<li>Scheduling Posts and Pages to Be Published Later<\/li>\n<li>Previewing Posts and Pages<\/li>\n<li>Publishing Posts and Pages<\/li>\n<li>Editing Existing Posts and Pages<\/li>\n<li>Deleting Posts and Pages<\/li>\n<\/ul>\n<figure class=\"wp-caption aligncenter\" data-caption=\"true\"><img loading=\"lazy\" decoding=\"async\" class=\"attachment-490x490\" src=\"https:\/\/wpmudev.com\/blog\/wp-content\/uploads\/2015\/07\/wordpress-login1.png\" alt=\"How to log in to WordPress is a natural step you will need to explain to new users.\" width=\"490\" height=\"312\" \/><figcaption class=\"wp-caption-text\">How to log in to WordPress is a natural step you will need to explain to new users.<\/figcaption><\/figure>\n<p>That\u2019s a lot of stuff, and some of these could be broken up and elaborated on even further with more detail.<\/p>\n<p>Remember to keep your main sections and subsections in line with the needs of your ideal user. Regularly referring to the user profile you wrote up in the beginning can help with this.<\/p>\n<p>Don\u2019t overwhelm your users\u00a0with information or functions you know they don\u2019t necessarily need to know or use, but also make sure you\u2019re not skimping on areas that are important and essential to the content publishing, customization, and maintenance of their site.<\/p>\n<h2 id=\"visual-steps\">4. Use a Visual Step-By-Step Process<\/h2>\n<p>A big\u00a0chunk of your user manual is likely going to be screenshots, and you should aim to show every consecutive step that a WordPress beginner would need to see in order to seamlessly follow along and avoid missing a step or getting confused. When you\u2019re planning out how to display your screenshots, consider the following:<\/p>\n<ul>\n<li>Incorporate numbered steps for\u00a0each screenshot (or a combination of screenshots) and supporting text to make it easy for the user to follow in the right order.<\/li>\n<li>Write the content of the entire manual in landscape orientation to facilitate full-page screenshots that are of high quality and very readable.<\/li>\n<li>Use a photo editing or graphic design program to add labels, arrows, circles, extra notes, and anything else to draw attention to certain areas of the screenshot.<\/li>\n<li>Use bright colors to emphasize those labels, arrows, and other edited components on the screenshots<\/li>\n<\/ul>\n<h2 id=\"descriptive-explanations\">5. Support the Visuals with Descriptive Explanations<\/h2>\n<p>Visuals are crucial, but they can still create a lot of confusion without appropriate explanations. Before delving\u00a0straight into the step-by-step process of a particular WordPress activity, first explain what the user is trying to accomplish and why it should be accomplished. Any functions included in the process should also have an explanation so the user knows what they\u2019re used for \u2013 not just how to use them. When writing out your text, you should aim to:<\/p>\n<ul>\n<li>Break up long paragraphs as much as possible.<\/li>\n<li>Use screenshots directly beneath the corresponding text as opposed to grouping them together after one or more pages of text.<\/li>\n<li>Define WordPress terminology that may be used throughout the text.<\/li>\n<li><span style=\"line-height: 1.5;\">Add links to other resources or video tutorials that users can refer to for more information.<\/span><\/li>\n<\/ul>\n<h2 id=\"extras\">6. Include Helpful Extras<\/h2>\n<p>Obviously, the instructions are the meat of your user manual, and it\u2019s what matters most. But there are lots of additional\u00a0sections you can add to the beginning and the end of your manual for a more complete and well-rounded user experience.<\/p>\n<p><strong>Table of Contents:<\/strong> Your manual is going to have a lot of sections and subsections of instructions, and you want to make it as easy as possible for users to find the instruction set they need for any particular problem. Having a complete table of contests of all sections and subsections and their corresponding pages is absolutely crucial.<\/p>\n<p><strong>Section Summaries:<\/strong> At the end of every section, or even every subsection if you so choose, you can include a brief summary of what the user learned and the main points that were covered.<\/p>\n<p><strong>Site Maintenance Section:<\/strong> An optional main section to have is one that goes into deeper detail about maintaining the site and updating existing posts, pages, widgets, categories, menus, appearance components, and anything else. You could explain what should be regularly updated, how often it should be updated, and how to go about doing it if the user wants to do it himself.<\/p>\n<p><strong>FAQ Section:<\/strong>\u00a0Users love FAQ sections, and it&#8217;s one of the best places to present solutions to the most common problems. If you need ideas for your FAQs, try looking around at what people are asking about in the <a href=\"https:\/\/wpmudev.com\/forums\/\" target=\"_blank\">WPMU DEV forums<\/a> or any other WordPress forums.<\/p>\n<figure class=\"wp-caption aligncenter\" data-caption=\"true\"><img loading=\"lazy\" decoding=\"async\" class=\"attachment-490x490\" src=\"https:\/\/wpmudev.com\/blog\/wp-content\/uploads\/2015\/04\/codex.png\" alt=\"Don't reinvent the wheel! The Codex is the first place you should look for detailed information about WordPress.\" width=\"490\" height=\"374\" \/><figcaption class=\"wp-caption-text\">Don&#8217;t reinvent the wheel! The Codex is the first place you should look for detailed information about WordPress.<\/figcaption><\/figure>\n<p><strong style=\"line-height: 1.5;\">Resources Section:<\/strong><span style=\"line-height: 1.5;\">\u00a0<\/span><span style=\"line-height: 1.5;\">There\u2019s only so much information you can include in your manual, and even if you make it as detailed as you can, there\u2019s still always more to learn and do with WordPress.<\/span><\/p>\n<p><span style=\"line-height: 1.5;\">Adding a Resources section with links to the\u00a0<\/span><a style=\"line-height: 1.5;\" href=\"https:\/\/codex.wordpress.org\/\" target=\"_blank\">WordPress.org Codex<\/a><span style=\"line-height: 1.5;\">, helpful WPMU DEV articles (natch!), and video tutorials on YouTube will help point users in the right direction when they need more help.<\/span><\/p>\n<p><strong>Glossary Section:<\/strong> Complete beginners aren\u2019t going to have a clue about technical terms. Even though you should explain their meanings the first time you present them in the instructions, having a glossary section at the back of your manual for quick reference is extremely useful.<\/p>\n<p><strong>Support Section:<\/strong> Where can your users get help when they\u2019re stuck? Can they contact you or someone else? Is there a forum or a support desk they should refer to? When the manual nor the extra online resources can answer a user\u2019s questions, they should be able to find out how and where to get help from an actual person.<\/p>\n<p><strong>Quick Start Guide:<\/strong> Although not necessary, developing an extra little manual or section that goes at the beginning of your manual to help users publish or edit their content as fast as possible would be a good asset for those users who are short on time and want instructions that get straight to the point. A \u201cQuick Start\u201d Guide is made to do just that, by summing up just the essentials.<\/p>\n<p><strong>Hardcopy and Online Copy Options:<\/strong> Offer your clients the option of getting the manual in both hardcopy and an online copy, such as a PDF document. A hardcopy will make it easy to following along while\u00a0using their WordPress site on a\u00a0computer, and an online copy will be useful for clicking on links to other resources or tutorials.<\/p>\n<p><strong>Regular Updating for New WordPress Releases:<\/strong> Aim to update your user manual every few months or so in order to reflect the most current WordPress version. While you can get away with handing out\u00a0a manual that\u2019s just slightly off from the current WordPress version, leaving it for too long will no doubt create issues for users. Problems will only snowball once they start noticing big differences between the outdated information in the manual and the workings of their WordPress site.<\/p>\n<h2 id=\"review\">7. Get Someone to Review Your Manual<\/h2>\n<p>Before your finalize your manual and start printing off copies to hand out to your clients, you should\u00a0get at least one other person\u2019s input on it to find out if it serves the\u00a0user as well as it should. Even if you think you covered everything, someone else might notice something you&#8217;ve missed or needs clarification \u2013 especially if that person has no prior WordPress knowledge.<\/p>\n<h2>Wrapping Up<\/h2>\n<p>Creating a complete user manual for someone unfamiliar with WordPress can feel like a daunting task but, by approaching the task in a logical and organized manner, it can become a great resource for your clients.<\/p>\n<p>To recap, here are those seven steps again:<\/p>\n<ol>\n<li>Begin with an introductory overview.<\/li>\n<li>Break up the main WordPress components into sections.<\/li>\n<li>Add subsections to the main sections.<\/li>\n<li>Use a visual step-by-step process.<\/li>\n<li>Support the visuals with descriptive explanations.<\/li>\n<li>Include helpful extras.<\/li>\n<li>Get someone to review your manual.<\/li>\n<\/ol>\n<p><em>Tip:<\/em> If you want to save yourself a whole lot of time and hassle creating the above, then check out\u00a0<a href=\"https:\/\/wptrainingmanual.com\" rel=\"noopener\" target=\"_blank\">WPTrainingManual.com<\/a>. It provides free access to 130+ downloadable WordPress step-by-step tutorials for your clients and end-users with detailed and regularly updated content.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Teaching WordPress to anyone who has never used the platform before can be a huge and daunting task \u2013 especially for clients who want to keep a close eye on everything you do for them. Here some essential tips to consider when putting together your first WordPress instruction manual.<\/p>\n","protected":false},"author":37930,"featured_media":207607,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"blog_reading_time":"","wds_primary_category":0,"wds_primary_tutorials_categories":0,"footnotes":""},"categories":[263],"tags":[10186,9798],"tutorials_categories":[],"class_list":["post-143585","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tutorials","tag-user-manuals","tag-weekend-wordpress-projects"],"_links":{"self":[{"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/posts\/143585","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/users\/37930"}],"replies":[{"embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/comments?post=143585"}],"version-history":[{"count":20,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/posts\/143585\/revisions"}],"predecessor-version":[{"id":218116,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/posts\/143585\/revisions\/218116"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/media\/207607"}],"wp:attachment":[{"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/media?parent=143585"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/categories?post=143585"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/tags?post=143585"},{"taxonomy":"tutorials_categories","embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/tutorials_categories?post=143585"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}