{"id":36472,"date":"2020-05-29T10:00:16","date_gmt":"2020-05-29T14:00:16","guid":{"rendered":"https:\/\/simpleprogrammer.com\/?p=36472"},"modified":"2020-05-29T09:03:18","modified_gmt":"2020-05-29T13:03:18","slug":"write-visual-end-user-guide","status":"publish","type":"post","link":"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/","title":{"rendered":"How To Write a Visual End-User Guide for Your Software"},"content":{"rendered":"<p><em><img loading=\"lazy\" decoding=\"async\" class=\"alignright wp-image-36486\" src=\"https:\/\/simpleprogrammer.com\/wp-content\/uploads\/2020\/05\/How-To-Write-a-Visual-End-User-Guide-for-Your-Software-square.png\" alt=\"write visual end-user guide\" width=\"280\" height=\"280\" \/>\u201cWriting is easy. All you have to do is cross out the wrong words.\u201d \u2014 Mark Twain<\/em><\/p>\n<p>The irony is not lost on me that this is a long-form text guide on how to write visual end-user guides. I initially considered offering this as a visual document instead of a blog post, but the truth is that some ideas are best communicated via text.<\/p>\n<p>I have seen too much bad end-user documentation over the years, and I have fixed many end-user guides for software written for internal users.<\/p>\n<p>I have heard complaints from users that the software or solution in question is not user friendly. While this post is not about good UI\/UX design, many times the technical writers writing the end-user guide contribute to the strain of the end user.<\/p>\n<p>These technical writers may not be the ones who developed the software, so they are likely not to have input on the UI\/UX design. Still, they can alleviate some of the end users\u2019 burden by writing decent visual guides.<\/p>\n<p>In recent years, there has been a proliferation of software and tools behind corporate firewalls, and some of the guides I have seen are rather cringeworthy. Some \u201cgems\u201d I have seen over the years include:<\/p>\n<ul>\n<li>Click where it says \u201cClick Here\u201d<\/li>\n<li>Please wait while the screen is finishing loading<\/li>\n<li>\u201cHow To Find This Document\u201d (If I am reading it, haven\u2019t I found it already?)<\/li>\n<li>Do not click \u201cCancel\u201d<\/li>\n<\/ul>\n<p>In this post, I am going to show you how to write a visual end-user guide that is easy to read and uses visuals and diagrams to guide the user on how to use your software, section by section. <a href=\"https:\/\/simpleprogrammer.com\/value-status-reports\/\" target=\"_blank\" rel=\"noopener noreferrer\">I get that software developers don\u2019t like writing non-code<\/a>. However, if you want your software to be liked, writing a good end-user guide is an essential skill even if all you do is help the tech writer.<\/p>\n<p>Before I actually begin, let me emphasize that<strong> good technical writing is not about getting people to read your document but to <em>skip<\/em> your document<\/strong>. You don\u2019t want anyone to have to read any part of your document they don\u2019t absolutely have to, so keep this basic principle in mind when writing your guides and the rest of this post will make a lot more sense.<\/p>\n<h2>Writing the Title Page<\/h2>\n<p>The first visual element in your guide is your title page. This is where your process of elimination should begin.Your first process of elimination is to weed out those people who don\u2019t need to read the document and attract those who do.<\/p>\n<p>Because of this, you need to include a publication date on your title page. This will help the reader determine if the publication is too old or too new for the area of software they are trying to study.<\/p>\n<p>The user should be able to read the title and publication date and determine whether or not they want to read the document.<\/p>\n<p>Remember, your document will get emailed around, published on the corporate intranet, and linked from the software.<\/p>\n<p>For that reason, include a logo for your software to act as a visual marker for anyone that may be interested in the document. Also include a descriptive title so that if someone were to read it, they could determine if they should read further.<\/p>\n<p><strong>Some bad sample titles include:<\/strong><\/p>\n<ul>\n<li>End-User Guide (end-user guide to what software?)<\/li>\n<li>How-to Guide<\/li>\n<li>User Release Notes<\/li>\n<\/ul>\n<p><strong>Good titles include:<\/strong><\/p>\n<ul>\n<li>End-User Guide for Legal Department (How to Perform Reviews of Legal Memorandums)<\/li>\n<li>How to Perform Legal Reviews of Memorandums in the Legal Documents Review System<\/li>\n<li>User Guide to Performing Legal Review of Customer Memorandums in Document Review System<\/li>\n<\/ul>\n<p>Notice each title tells the user you don\u2019t need to read this if you are not in the legal department. You don\u2019t need to read this if you are not performing a legal review, and if you are not involved in the legal review of customer memorandums, you will not find this guide useful.<\/p>\n<p>Remember the process of elimination? You should be getting rid of the uninterested users right from the title page.<\/p>\n<h2>Table of Contents<\/h2>\n<p>I prefer to write the table of contents (TOC) before I write the rest of the document. Most modern word processors create a table of contents for you, but writing one yourself ahead of time has multiple benefits. It gives you a roadmap of what you should write and helps organize your thoughts.<\/p>\n<p>The table of contents is also the second visual element of your guide. I know that it consists mostly of text, but the text, the indentation, the grouping, and font all matter in terms of aesthetics.<\/p>\n<p>In writing a good table of contents,<a href=\"http:\/\/www.amazon.com\/exec\/obidos\/ASIN\/B0054KOL74\/makithecompsi-20\" target=\"_blank\" rel=\"noopener noreferrer\"> the stories of the software in question<\/a> should be your guide.<\/p>\n<p><strong>Write each section as you would start <a href=\"https:\/\/www.mountaingoatsoftware.com\/agile\/user-stories\" target=\"_blank\" rel=\"noopener noreferrer\">a user story<\/a>.\u00a0<\/strong><\/p>\n<p>Take this opening statement for example, \u201cAs an attorney, I would like to \u2026\u201d<\/p>\n<p>This tells the user that if they are not an attorney, they should skip that section, as it will have little to no benefit for them.<\/p>\n<p>Also, the order of the sections matters. You should write the stories in the order of the number of users. For example, if there are more attorneys who will be using the software, you should write the attorney section first, then the most important user populations, and so on.<\/p>\n<p>For each subsection, write the sentence as you would in a story similar to what the user would like to accomplish.<\/p>\n<p>Since your section started with \u201cAs an attorney I would like to \u2026,\u201d each subsection should refer to what the attorney would like to do, such as \u201creview a document in my queue\u201d or \u201creturn a document in my queue to the office administrator for further edits,\u201d etc.<\/p>\n<p>Again, each subsection should be in the order the user is most likely to perform tasks. If an attorney is most likely to perform task A, it should be first, and then task B, and so on.<\/p>\n<p>The table of contents should be limited to two pages. If you have more than two pages of contents, perhaps you should consider splitting the guide. For example three separate guides for three separate personas\/users. This way, you\u2019re still able to discuss all aspects of your software in an easy-to-follow way.<\/p>\n<p><a href=\"https:\/\/en.wikipedia.org\/wiki\/Agile_software_development\" target=\"_blank\" rel=\"noopener noreferrer\">If you are familiar with Agile, you will be familiar with user stories and epics<\/a>. Use the personas you developed in <a href=\"https:\/\/simpleprogrammer.com\/how-to-hang-a-picture-agile-user-stories\/\" target=\"_blank\" rel=\"noopener noreferrer\">your stories<\/a> and the goals each persona would like to accomplish as a guide to writing the section headers.<\/p>\n<p>Use the process of elimination. Wear the users shoes. Reading your guide is not their job; they just need to perform a task and get back to their regular job, so it should be easy for them to find what they need.<\/p>\n<p>The visual cues to provide in your TOC are:<\/p>\n<ul>\n<li>Clear grouping of tasks to be accomplished by a single persona<\/li>\n<li>Separation of personas by section<\/li>\n<li>Clear hierarchy of the tasks (most frequent first)<\/li>\n<\/ul>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-36473 size-full\" src=\"https:\/\/simpleprogrammer.com\/wp-content\/uploads\/2020\/05\/table-of-contents-image.png\" alt=\"write visual end-user guide\" width=\"1600\" height=\"639\" \/><\/p>\n<p>A table of figures (TOF) is another important visual element, and yes, it is a visual representation of visual elements.<\/p>\n<p>Not every screenshot in your document deserves a citation in the table of figures. Include only those screenshots in the TOF that are of particular importance. Perhaps a process flow or a schematic of a part.<\/p>\n<h2>Section<\/h2>\n<p>Each section and subsection should be written as: \u201cAs a persona, I would like to accomplish my goal.\u201d<\/p>\n<p>As each subsection should be titled with the goal the person would like to accomplish, write each subsection with the steps the user must take in order to accomplish that goal.<\/p>\n<p>Never assume that a user knows something or has done something up to that point. Assume the user has never used the system, and assume that the user has done nothing.<\/p>\n<p>If there are pre-steps to performing the tasks, provide a link to the section for performing those pre-steps. For example, how to log in to the system. If you don\u2019t have a login, how to request access to the system. Never assume that a user has done those steps already. Tell them where to look for that information.<\/p>\n<p>Always provide all the information in the document, every minute detail. For example, include the URL to the system, and don\u2019t assume the user knows it.<\/p>\n<p>Remember that this is a visual guide. Even the way you breakup the steps must be a visual cue to the reader.<\/p>\n<p>Start each subsection with steps. Each step should consist of two complementary pieces, the text and the screenshot. The text is a visual complement to the screenshots while the screenshots are visual complements to the text.<\/p>\n<h2>Text<\/h2>\n<p>The text for each step should contain the steps numbered 1, 2, 3, etc. and contain text instructions on how to accomplish the task. This will help the reader keep track of each step, giving them a number to refer back to when they\u2019ve stopped.<\/p>\n<p>I always like to do the task in question while I write so I don\u2019t skip any steps.<\/p>\n<ul>\n<li>Navigate to the homepage of the site by clicking the following URL:<br \/>\n<a href=\"http:\/\/www.google.com\" target=\"_blank\" rel=\"noopener noreferrer\">http:\/\/www.google.com<\/a><\/li>\n<\/ul>\n<p>Remember to never assume. The user may not know the URL to Google (yes, really).<\/p>\n<p>Bonus points if you include small screenshots within the text.<\/p>\n<p>This text is good:<\/p>\n<ul>\n<li>Click the \u201cSign in\u201d button.<\/li>\n<\/ul>\n<p>This is better:<\/p>\n<ul>\n<li>Click the\u00a0 <img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-36474\" src=\"https:\/\/simpleprogrammer.com\/wp-content\/uploads\/2020\/05\/sign-in-button.png\" alt=\"\" width=\"51\" height=\"23\" \/>\u00a0 button.<\/li>\n<\/ul>\n<p>This provides an inline visual cue for the reader, allowing them to see exactly what they\u2019ll be looking for.<\/p>\n<h2>Screenshots<\/h2>\n<p>Each screenshot should have a border. The user must be able to tell visually where your screenshot ends and the document begins, <em>especially<\/em> if the screenshot and the document have the same background color.<\/p>\n<p>Have you ever read a document where the screenshots and the page are the same color? I have read too many, and it is quite an assault on the eyes. So be kind to your reader so that they can visually tell where everything starts and ends.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-36475 size-full\" src=\"https:\/\/simpleprogrammer.com\/wp-content\/uploads\/2020\/05\/screenshot-image.png\" alt=\"write visual end-user guide\" width=\"1600\" height=\"961\" \/><\/p>\n<p>The screenshot should give the user context and visual cues of where they need to focus. It is not good enough that you included the screenshot; you must now focus the user. There are multiple strategies for doing this. <a href=\"http:\/\/www.amazon.com\/exec\/obidos\/ASIN\/B07ZGDKN3B\/makithecompsi-20\" target=\"_blank\" rel=\"noopener noreferrer\">My favorite screenshotting tool is SnagIt<\/a>. You can:<\/p>\n<ul>\n<li>Blur the rest of the image.<img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-36476\" src=\"https:\/\/simpleprogrammer.com\/wp-content\/uploads\/2020\/05\/screenshot-blur-image.png\" alt=\"\" width=\"1600\" height=\"961\" \/><\/li>\n<li>Magnify the section the user must focus on in that step.<img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-36477\" src=\"https:\/\/simpleprogrammer.com\/wp-content\/uploads\/2020\/05\/screenshot-sign-in.png\" alt=\"\" width=\"1600\" height=\"961\" \/><\/li>\n<li style=\"font-weight: 400;\">Provide an arrow to the area.<img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-36478 size-full\" src=\"https:\/\/simpleprogrammer.com\/wp-content\/uploads\/2020\/05\/screenshot-arrow.png\" alt=\"write visual end-user guide\" width=\"1600\" height=\"961\" \/><span style=\"font-weight: 400;\"><br \/>\n<\/span><\/li>\n<\/ul>\n<p>Or a combination thereof. <strong>Remember, you want to provide as many visual cues as necessary to make it easy for the user. <\/strong>However, use effects sparingly, and use your best judgment. My rule of thumb is three effects should suffice to focus the user\u2019s attention. Any more just distracts from the screenshots.<\/p>\n<p>Each step and its associated screenshot should be indented to the same level. If there are substeps, the screenshot of the substep should be indented to the substep.<\/p>\n<p>Since this guide is about making it visual, you should have enough screenshots such that if all the text in the document was not there, the user should be able to accomplish the task just by looking at the screenshots.<\/p>\n<p>You want the user to be able to understand exactly what they need to do without having to read any of the text. That\u2019s how many screenshots you should have, as many as it takes. One trick while in the editing stage is to turn the text white, and see if you can still follow the screenshots without any text help to accomplish the task.<\/p>\n<p>In connection with that, the text should also be written without the screenshots in mind. Delete the screenshots, and see if you can follow the instructions and accomplish the task with text only.<\/p>\n<p>Both should be easy to follow so that any person of any skill range can complete the task. If you\u2019re not quite sure of your text\u2019s difficulty, you can always ask a friend to read it over for you, preferably someone who doesn\u2019t understand the material, and see if they can grasp what is going on. If they can understand it, then you\u2019re good!<\/p>\n<h2>Keep It Simple, Silly<\/h2>\n<p>In summary, write software guides with a visual title page, a great description, a table of contents, and clear sections.<\/p>\n<p>Write the table of contents in persona form such that if a user is not that persona, they can skip that section and focus only on the section they need to read to accomplish their task.<\/p>\n<p>In each section, include all the text and screenshots the user will need to accomplish the task, and ideally, do the task while writing the guide so you don\u2019t miss anything.<\/p>\n<p>By doing this, you just might reduce some of the burden from end-users, and they will thank you for it.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u201cWriting is easy. All you have to do is cross out the wrong words.\u201d \u2014 Mark Twain The irony is not lost on me that this is a long-form text guide on how to write visual end-user guides. I initially considered offering this as a visual document instead of a blog post, but the truth&#8230;<\/p>\n","protected":false},"author":1276,"featured_media":36487,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","footnotes":""},"categories":[162229812,162228966,415,264,162229840,162229823,1981,162229540],"tags":[],"class_list":["post-36472","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-advice","category-education-2","category-guest-post","category-learning","category-skills","category-software","category-tools","category-writing-2"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>How To Write a Visual End-User Guide for Your Software - Simple Programmer<\/title>\n<meta name=\"description\" content=\"In this post, you&#039;ll learn how to write a visual end-user guide that is easy to read and uses diagrams to guide the user on how to use your software.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How To Write a Visual End-User Guide for Your Software - Simple Programmer\" \/>\n<meta property=\"og:description\" content=\"In this post, you&#039;ll learn how to write a visual end-user guide that is easy to read and uses diagrams to guide the user on how to use your software.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/\" \/>\n<meta property=\"og:site_name\" content=\"Simple Programmer\" \/>\n<meta property=\"article:published_time\" content=\"2020-05-29T14:00:16+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/simpleprogrammer.com\/wp-content\/uploads\/2020\/05\/How-To-Write-a-Visual-End-User-Guide-for-Your-Software.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1280\" \/>\n\t<meta property=\"og:image:height\" content=\"720\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"11 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/simpleprogrammer.com\\\/write-visual-end-user-guide\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/simpleprogrammer.com\\\/write-visual-end-user-guide\\\/\"},\"author\":{\"name\":\"\",\"@id\":\"\"},\"headline\":\"How To Write a Visual End-User Guide for Your Software\",\"datePublished\":\"2020-05-29T14:00:16+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/simpleprogrammer.com\\\/write-visual-end-user-guide\\\/\"},\"wordCount\":2153,\"commentCount\":0,\"image\":{\"@id\":\"https:\\\/\\\/simpleprogrammer.com\\\/write-visual-end-user-guide\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/simpleprogrammer.com\\\/wp-content\\\/uploads\\\/2020\\\/05\\\/How-To-Write-a-Visual-End-User-Guide-for-Your-Software.png\",\"articleSection\":[\"Advice\",\"Education\",\"Guest Post\",\"Learning\",\"Skills\",\"Software\",\"Tools\",\"Writing\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/simpleprogrammer.com\\\/write-visual-end-user-guide\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/simpleprogrammer.com\\\/write-visual-end-user-guide\\\/\",\"url\":\"https:\\\/\\\/simpleprogrammer.com\\\/write-visual-end-user-guide\\\/\",\"name\":\"How To Write a Visual End-User Guide for Your Software - Simple Programmer\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/simpleprogrammer.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/simpleprogrammer.com\\\/write-visual-end-user-guide\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/simpleprogrammer.com\\\/write-visual-end-user-guide\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/simpleprogrammer.com\\\/wp-content\\\/uploads\\\/2020\\\/05\\\/How-To-Write-a-Visual-End-User-Guide-for-Your-Software.png\",\"datePublished\":\"2020-05-29T14:00:16+00:00\",\"author\":{\"@id\":\"\"},\"description\":\"In this post, you'll learn how to write a visual end-user guide that is easy to read and uses diagrams to guide the user on how to use your software.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/simpleprogrammer.com\\\/write-visual-end-user-guide\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/simpleprogrammer.com\\\/write-visual-end-user-guide\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/simpleprogrammer.com\\\/write-visual-end-user-guide\\\/#primaryimage\",\"url\":\"https:\\\/\\\/simpleprogrammer.com\\\/wp-content\\\/uploads\\\/2020\\\/05\\\/How-To-Write-a-Visual-End-User-Guide-for-Your-Software.png\",\"contentUrl\":\"https:\\\/\\\/simpleprogrammer.com\\\/wp-content\\\/uploads\\\/2020\\\/05\\\/How-To-Write-a-Visual-End-User-Guide-for-Your-Software.png\",\"width\":1280,\"height\":720},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/simpleprogrammer.com\\\/write-visual-end-user-guide\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/simpleprogrammer.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How To Write a Visual End-User Guide for Your Software\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/simpleprogrammer.com\\\/#website\",\"url\":\"https:\\\/\\\/simpleprogrammer.com\\\/\",\"name\":\"Simple Programmer\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/simpleprogrammer.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"\",\"url\":\"https:\\\/\\\/simpleprogrammer.com\\\/author\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How To Write a Visual End-User Guide for Your Software - Simple Programmer","description":"In this post, you'll learn how to write a visual end-user guide that is easy to read and uses diagrams to guide the user on how to use your software.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/","og_locale":"en_US","og_type":"article","og_title":"How To Write a Visual End-User Guide for Your Software - Simple Programmer","og_description":"In this post, you'll learn how to write a visual end-user guide that is easy to read and uses diagrams to guide the user on how to use your software.","og_url":"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/","og_site_name":"Simple Programmer","article_published_time":"2020-05-29T14:00:16+00:00","og_image":[{"width":1280,"height":720,"url":"https:\/\/simpleprogrammer.com\/wp-content\/uploads\/2020\/05\/How-To-Write-a-Visual-End-User-Guide-for-Your-Software.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Written by":"","Est. reading time":"11 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/#article","isPartOf":{"@id":"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/"},"author":{"name":"","@id":""},"headline":"How To Write a Visual End-User Guide for Your Software","datePublished":"2020-05-29T14:00:16+00:00","mainEntityOfPage":{"@id":"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/"},"wordCount":2153,"commentCount":0,"image":{"@id":"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/#primaryimage"},"thumbnailUrl":"https:\/\/simpleprogrammer.com\/wp-content\/uploads\/2020\/05\/How-To-Write-a-Visual-End-User-Guide-for-Your-Software.png","articleSection":["Advice","Education","Guest Post","Learning","Skills","Software","Tools","Writing"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/","url":"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/","name":"How To Write a Visual End-User Guide for Your Software - Simple Programmer","isPartOf":{"@id":"https:\/\/simpleprogrammer.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/#primaryimage"},"image":{"@id":"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/#primaryimage"},"thumbnailUrl":"https:\/\/simpleprogrammer.com\/wp-content\/uploads\/2020\/05\/How-To-Write-a-Visual-End-User-Guide-for-Your-Software.png","datePublished":"2020-05-29T14:00:16+00:00","author":{"@id":""},"description":"In this post, you'll learn how to write a visual end-user guide that is easy to read and uses diagrams to guide the user on how to use your software.","breadcrumb":{"@id":"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/#primaryimage","url":"https:\/\/simpleprogrammer.com\/wp-content\/uploads\/2020\/05\/How-To-Write-a-Visual-End-User-Guide-for-Your-Software.png","contentUrl":"https:\/\/simpleprogrammer.com\/wp-content\/uploads\/2020\/05\/How-To-Write-a-Visual-End-User-Guide-for-Your-Software.png","width":1280,"height":720},{"@type":"BreadcrumbList","@id":"https:\/\/simpleprogrammer.com\/write-visual-end-user-guide\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/simpleprogrammer.com\/"},{"@type":"ListItem","position":2,"name":"How To Write a Visual End-User Guide for Your Software"}]},{"@type":"WebSite","@id":"https:\/\/simpleprogrammer.com\/#website","url":"https:\/\/simpleprogrammer.com\/","name":"Simple Programmer","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/simpleprogrammer.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"","url":"https:\/\/simpleprogrammer.com\/author\/"}]}},"_links":{"self":[{"href":"https:\/\/simpleprogrammer.com\/wp-json\/wp\/v2\/posts\/36472","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/simpleprogrammer.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/simpleprogrammer.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/simpleprogrammer.com\/wp-json\/wp\/v2\/users\/1276"}],"replies":[{"embeddable":true,"href":"https:\/\/simpleprogrammer.com\/wp-json\/wp\/v2\/comments?post=36472"}],"version-history":[{"count":0,"href":"https:\/\/simpleprogrammer.com\/wp-json\/wp\/v2\/posts\/36472\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/simpleprogrammer.com\/wp-json\/wp\/v2\/media\/36487"}],"wp:attachment":[{"href":"https:\/\/simpleprogrammer.com\/wp-json\/wp\/v2\/media?parent=36472"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/simpleprogrammer.com\/wp-json\/wp\/v2\/categories?post=36472"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/simpleprogrammer.com\/wp-json\/wp\/v2\/tags?post=36472"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}