{"id":304612,"date":"2024-12-30T08:30:00","date_gmt":"2024-12-30T13:30:00","guid":{"rendered":"https:\/\/www.techsmith.com\/learn\/?post_type=tutorial&#038;p=304612"},"modified":"2025-06-03T08:27:13","modified_gmt":"2025-06-03T12:27:13","slug":"writing-helpful-help","status":"publish","type":"tutorial","link":"https:\/\/www.techsmith.com\/learn\/tutorials\/academy\/writing-helpful-help\/","title":{"rendered":"Writing Helpful Help"},"content":{"rendered":"<div id=\"bsf_rt_marker\"><\/div>\n<div class=\"wp-block-group\"><div class=\"wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained\">\n<p>Michele Wiedemer of&nbsp;<a href=\"http:\/\/www.virtualcustomerlearning.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">Virtual Customer Learning<\/a>&nbsp;has been helping companies create how-to resources for their customers for over 20 years. In this course, she shares her expertise in providing content that helps customers help themselves.<\/p>\n\n\n\n<p>This course looks at Michele&#8217;s three principles for creating effective Help center content:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Deciding what to write<\/li>\n\n\n\n<li>Making it look good<\/li>\n\n\n\n<li>Making it easy to find<\/li>\n<\/ul>\n\n\n\n<p><\/p>\n<\/div><\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-1-1-introduction\">1.1 Introduction<\/h2>\n\n\n\n\t<div class=\"dx-block-wistia-embed\">\n\t\t<script type=\"text\/javascript\" src=\"https:\/\/fast.wistia.com\/embed\/medias\/rif4mrlb8a.jsonp\" async=\"async\"><\/script>\n\n\t\t<div class=\"wistia_responsive_padding\">\n\t\t\t<div class=\"wistia_responsive_wrapper\">\n\t\t\t\t\t\t\t\t\t<div class=\"wistia_embed wistia_async_rif4mrlb8a videoFoam=true\">&nbsp;<\/div>\n\t\t\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t<\/div>\n\n\n\n<p>Connect with Michele at:&nbsp;<a href=\"https:\/\/nam12.safelinks.protection.outlook.com\/?url=http%3A%2F%2Fwww.linkedin.com%2Fin%2Fmichele-wiedemer&amp;data=05%7C02%7Cm.pierce%40techsmith.com%7C11c9e494269147038d4108dca05b32c0%7C77d3096378724d1193742c2b2a12ad65%7C0%7C0%7C638561560796848428%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C0%7C%7C%7C&amp;sdata=0l0i7uUDNVc71T4Dr6JOoTUrelHzQBP9GjLWl0apjXM%3D&amp;reserved=0\">https:\/\/linkedin.com\/in\/michele-wiedemer<\/a><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-1-2-what-is-your-help-goal\">1.2 What is Your Help Goal?<\/h2>\n\n\n\n\t<div class=\"dx-block-wistia-embed\">\n\t\t<script type=\"text\/javascript\" src=\"https:\/\/fast.wistia.com\/embed\/medias\/amamj4npcq.jsonp\" async=\"async\"><\/script>\n\n\t\t<div class=\"wistia_responsive_padding\">\n\t\t\t<div class=\"wistia_responsive_wrapper\">\n\t\t\t\t\t\t\t\t\t<div class=\"wistia_embed wistia_async_amamj4npcq videoFoam=true\">&nbsp;<\/div>\n\t\t\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t<\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-1-3-define-your-goal\">1.3 Define Your Goal<\/h2>\n\n\n\n<p>The previous lesson discussed five common goals companies have for their Help center content. Review the following questions and examples to help you define your own Help center content goal.<\/p>\n\n\n\n<p>As you start your Help center improvements, try to set a SMART goal. SMART goals are:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Specific<\/li>\n\n\n\n<li>Measurable<\/li>\n\n\n\n<li>Achievable<\/li>\n\n\n\n<li>Relevant, and<\/li>\n\n\n\n<li>Time-bound<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-reduce-support-costs\"><strong>Reduce Support Costs<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>What are your top 5 support requests?&nbsp;<\/li>\n\n\n\n<li>Do any of those requests represent how-to questions?&nbsp;<\/li>\n\n\n\n<li>How much time does support staff spend answering the same questions?&nbsp;<\/li>\n\n\n\n<li>What $$ does that time represent?<\/li>\n\n\n\n<li>Could support staff time be better spent on more complicated or individualized issues?&nbsp;<\/li>\n\n\n\n<li>Are other aspects of your business suffering because too much time is spent on support?<\/li>\n<\/ul>\n\n\n\n<p><strong>Example SMART goal:<\/strong>&nbsp;&#8220;I want to reduce support tickets by 10% for Q3.&#8221;<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-improve-customer-onboarding-experience\"><strong>Improve Customer Onboarding Experience<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Are there a set collection of steps that new users need to take to be successful with your product?&nbsp;<\/li>\n\n\n\n<li>How much time do Customer Success or other employees spend on helping new customers get oriented to your product?<\/li>\n\n\n\n<li>Even if you have a very technical product with a high-touch learning process, is there a way to standardize some of the content to support customers as they learn?<\/li>\n\n\n\n<li>If your goal for your Help center content is related to improving the customers\u2019 onboarding experiences, how will you measure that?&nbsp;<\/li>\n\n\n\n<li>Are you talking to customers about their impressions of your process or just collecting general satisfaction surveys?&nbsp;<\/li>\n\n\n\n<li>Do you have the tools and\/or data to connect customers who view your Help center with their renewal rates?<\/li>\n<\/ul>\n\n\n\n<p><strong>Example SMART goal:<\/strong>&nbsp;&#8220;I want to reduce CSM time spent onboarding new customers by an hour (from 6 hours average to 5 hours average) per account by the end of August.&#8221;<br><\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-improve-trial-or-freemium-conversion-rates\"><strong>Improve Trial or Freemium Conversion Rates<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>What are the most important tasks that convince trial or freemium users of the value of your product so they become paid customers?&nbsp;<\/li>\n\n\n\n<li>Can Help center content or a getting started guide provide a quick reference or job aid for performing those tasks?<\/li>\n\n\n\n<li>What is your current conversion rate?&nbsp;<\/li>\n\n\n\n<li>What percentage improvement would justify an investment in starting or improving your Help center content?<\/li>\n<\/ul>\n\n\n\n<p><strong>Example SMART goal:<\/strong>&nbsp;&#8220;I want to make an average of 10 additional sales per month (from my current average of 50) in 2025.&#8221;<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-support-feature-adoption\"><strong>Support Feature Adoption<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Do you have statistics on how features are used?&nbsp;<\/li>\n\n\n\n<li>Have you connected particular feature use with renewal rates?&nbsp;<\/li>\n\n\n\n<li>What kind of improvement in renewal rates can you expect as customers adopt additional features?<\/li>\n<\/ul>\n\n\n\n<p>If your goal is related to new feature adoption, you\u2019ll need to consider some additional logistics questions.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>How will your Help center authors work with the development team to understand new features?&nbsp;<\/li>\n\n\n\n<li>What is your release cycle?&nbsp;<\/li>\n\n\n\n<li>How can you incorporate Help center updates with product updates?&nbsp;<\/li>\n\n\n\n<li>Will you reuse Help Center content when marketing new features?<\/li>\n<\/ul>\n\n\n\n<p><strong>Example SMART goal:<\/strong>&nbsp;&#8220;I want at least 40% of our customers to use features in the 20.3 release within the first three weeks of release.&#8221;<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-begin-or-supplement-a-customer-education-initiative\"><strong>Begin or Supplement a Customer Education Initiative<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>What are the quick questions your customers ask?&nbsp;<\/li>\n\n\n\n<li>How do those questions currently get answered?&nbsp;<\/li>\n\n\n\n<li>Could that staff time be better spent on more complicated or customized guidance?&nbsp;<\/li>\n\n\n\n<li>What savings in time or money does that represent?<\/li>\n<\/ul>\n\n\n\n<p><strong>Example SMART goal:<\/strong>&nbsp;&#8220;I want to provide articles answering the top five questions customers ask by the end of the month.&#8221;<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-conclusion\"><strong>Conclusion<\/strong><\/h3>\n\n\n\n<p>Remember that defining one goal for now will help you focus your efforts as you get started or move to the next stage of development for your Help center.<\/p>\n\n\n\n<p>Making a SMART goal can help you justify the time and expense spent on creating helpful Help content.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-1-4-did-you-set-a-goal\">1.4 Did You Set a Goal?<\/h2>\n\n\n\n<p>Which most closely describes your organization&#8217;s overarching goal for a Help center?<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Reduce Support costs<\/li>\n\n\n\n<li>Improve customer onboarding<\/li>\n\n\n\n<li>Improve trial or Freemium conversion rates<\/li>\n\n\n\n<li>Support feature adoption<\/li>\n\n\n\n<li>Begin or supplement a Customer Education initiative<\/li>\n\n\n\n<li>Other<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">Summary<\/h3>\n\n\n\n<p>Remember that your goal may evolve and change over time. Just pick one to get started. Having one goal will help you stay focused and measure the effectiveness of your Help content efforts.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\" id=\"h-deciding-what-to-write\">Deciding What to Write  <\/h1>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-2-1-introduction\">2.1 Introduction<\/h2>\n\n\n\n\t<div class=\"dx-block-wistia-embed\">\n\t\t<script type=\"text\/javascript\" src=\"https:\/\/fast.wistia.com\/embed\/medias\/5zyc6xdtd3.jsonp\" async=\"async\"><\/script>\n\n\t\t<div class=\"wistia_responsive_padding\">\n\t\t\t<div class=\"wistia_responsive_wrapper\">\n\t\t\t\t\t\t\t\t\t<div class=\"wistia_embed wistia_async_5zyc6xdtd3 videoFoam=true\">&nbsp;<\/div>\n\t\t\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t<\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-2-2-don-t-write-chunk\">2.2 Don&#8217;t Write, Chunk! <\/h2>\n\n\n\n\t<div class=\"dx-block-wistia-embed\">\n\t\t<script type=\"text\/javascript\" src=\"https:\/\/fast.wistia.com\/embed\/medias\/p2493rkgt5.jsonp\" async=\"async\"><\/script>\n\n\t\t<div class=\"wistia_responsive_padding\">\n\t\t\t<div class=\"wistia_responsive_wrapper\">\n\t\t\t\t\t\t\t\t\t<div class=\"wistia_embed wistia_async_p2493rkgt5 videoFoam=true\">&nbsp;<\/div>\n\t\t\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t<\/div>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-summary\">Summary<\/h3>\n\n\n\n<p>You can <a href=\"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/Checklist_for_Evaluating_Topics.pdf\">download a checklist for evaluating your own content here<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-2-3-procedures-aren-t-everything\">2.3 Procedures Aren&#8217;t Everything<\/h2>\n\n\n\n<p>A good Help center is full of procedure topics. But procedures aren\u2019t everything.<\/p>\n\n\n\n<p>You may have conceptual information that users need for context and understanding before a procedure will make sense to the reader. Or maybe there&#8217;s an overall process that connects more than one procedure together.<\/p>\n\n\n\n<p>These types of topics CAN have a place in your Help center. They won\u2019t have exactly the same chunks, but you still want to break the information down.<\/p>\n\n\n\n<p>However, before including them, go back to your Help center goal. Many people try to have help that is all things to all people. That&#8217;s not realistic, especially when you are just starting out.<\/p>\n\n\n\n<p>While some conceptual information may be useful in setting up your procedures, it can clutter up the effectiveness of a good support framework if it&#8217;s not done right.<\/p>\n\n\n\n<p>If you find yourself wanting to include lots of conceptual information, maybe what you are trying to create is self-service training instead of help. There&#8217;s absolutely nothing wrong with creating self-service training, but online training is a more involved, more advanced project, not a Help center. Don\u2019t try to run before you\u2019ve learned to walk.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-2-4-don-t-assume-too-much\">2.4 Don&#8217;t Assume Too Much<\/h2>\n\n\n\n\t<div class=\"dx-block-wistia-embed\">\n\t\t<script type=\"text\/javascript\" src=\"https:\/\/fast.wistia.com\/embed\/medias\/efpm06kmbr.jsonp\" async=\"async\"><\/script>\n\n\t\t<div class=\"wistia_responsive_padding\">\n\t\t\t<div class=\"wistia_responsive_wrapper\">\n\t\t\t\t\t\t\t\t\t<div class=\"wistia_embed wistia_async_efpm06kmbr videoFoam=true\">&nbsp;<\/div>\n\t\t\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t<\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-2-5-explain-it-to-a-12-year-old\">2.5 Explain it to a 12-Year-Old<\/h2>\n\n\n\n<p>Another way to improve your help center writing is to check your readability. Your Help topics won\u2019t be helpful if readers can\u2019t understand your explanations. One of the ways you can do this is by checking the vocabulary you use.<\/p>\n\n\n\n<p>Dr. Suess wrote The Cat in the Hat as a new kind of children\u2019s reading primer (published in 1957) using a vocabulary of just 236 words most first-graders would know. And despite using such a limited vocabulary, it\u2019s gone on to be one of the top selling children\u2019s books of all time.<\/p>\n\n\n\n<p>Now, you don\u2019t have to aim your topics at a first-grade level.<\/p>\n\n\n\n<p>You can aim for a sixth to seventh grade reading level (or around age 12) to make the topics easy enough for most people to grasp without much effort, without also being patronizing or overly simplistic.<\/p>\n\n\n\n<p>Approaching your topics as if you are explaining them to a child can also help you focus on clear, concise content. Remove difficult or unfamiliar words (including jargon) so that a 12-year-old could understand it. This can be done even with complicated topics.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-summary-0\">Summary<\/h3>\n\n\n\n<p>A fun tool that can help you simplify your content is called the <a href=\"https:\/\/splasho.com\/upgoer5\/\">Up-Goer Five text editor<\/a>.<\/p>\n\n\n\n<p>The aim with using this tool is to stick to the 1000 most-used words in English. The tool will highlight any words in your text that are not on the list. (You can get away with using words not on the list if they are names of common items or tasks related to your product.)<\/p>\n\n\n\n<p>For highlighted words, challenge yourself to find different words to make the content more readable.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-2-6-decide-what-to-write-summary\">2.6 Decide What to Write Summary<\/h2>\n\n\n\n<p>When writing content for your Help center:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Chunk the information to make it easy to scan.<\/li>\n\n\n\n<li>Make sure you aren&#8217;t missing any steps.<\/li>\n\n\n\n<li>Stay focused. Link to other topics if needed to keep topics concise.<\/li>\n\n\n\n<li>Use simple, straight-forward sentences.<\/li>\n\n\n\n<li>Use words a 12-year-old would understand.<\/li>\n<\/ol>\n\n\n\n<h1 class=\"wp-block-heading\" id=\"h-making-it-look-good\">Making it Look Good<\/h1>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-3-1-introduction\">3.1 Introduction<\/h2>\n\n\n\n\t<div class=\"dx-block-wistia-embed\">\n\t\t<script type=\"text\/javascript\" src=\"https:\/\/fast.wistia.com\/embed\/medias\/4r5nw9zonf.jsonp\" async=\"async\"><\/script>\n\n\t\t<div class=\"wistia_responsive_padding\">\n\t\t\t<div class=\"wistia_responsive_wrapper\">\n\t\t\t\t\t\t\t\t\t<div class=\"wistia_embed wistia_async_4r5nw9zonf videoFoam=true\">&nbsp;<\/div>\n\t\t\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t<\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-3-2-style-is-not-just-for-designers\">3.2 Style is Not Just for Designers<\/h2>\n\n\n\n<p>You don\u2019t need to be a designer to make your content look good. You only need to know a few key concepts that can make a big difference.<\/p>\n\n\n\n<p>Remember that most of your readers are going to scan your Help center content. So you want to format text so that important details stand out. You do this with font, color, size and spacing.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Fonts<\/strong><\/h3>\n\n\n\n<p>When choosing fonts for your Help content, make sure they are easy to read. Serif fonts, used in traditional publishing, such as Times New Roman, have extra strokes in the typeface that can be harder to read on screen, though in some cases they can work if used sparingly.&nbsp;<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large is-resized\"><img decoding=\"async\" src=\"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/3.2-image-1.png\" alt=\"\" style=\"width:555px;height:auto\"\/><\/figure>\n<\/div>\n\n\n<p>Sans-serif fonts, such as Arial, Helvetica or Lato, are better for on-screen reading.&nbsp;<\/p>\n\n\n\n<p>You only want to use 2-3 fonts for your entire project: one for headings, one for body text, and maybe a third for the title or special information. Too many different fonts make for a cluttered experience. We want to avoid that clutter so the reader\u2019s eye flows easily across the screen.&nbsp;<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-font-decorations\"><strong>Font Decorations<\/strong><\/h3>\n\n\n\n<p>Bold and italic text are font decorations that can help important details stand out. My preference is to use italics for things like screen names and bold for anything the user touches (like button or field names).<\/p>\n\n\n\n<p>Depending on which font you choose, you may need to make adjustments. For example, italics may not be very readable on-screen in your font choice, so you might use color or another way of drawing attention to that text.<\/p>\n\n\n\n<p>I don\u2019t recommend using underline, with one exception. Hyperlinks tend to be underlined as the default formatting.<\/p>\n\n\n\n<p>You can use font choices like all capital letters or small caps in your text, but only extremely sparingly. All caps and small caps are also hard to read. You might consider using a different form of contrast, like a different color.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/3.2-2-image-1.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>Color is an important aspect of your visual design. But again, you just need a few &#8211; maybe 3 to 5, including your branding and main text color. You don\u2019t want too many colors &#8211; each with a complicated meaning. Keep it simple. A different color for headings and an accent color or two can really make the project more enjoyable to view.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-size-and-spacing\"><strong>Size and Spacing<\/strong><\/h3>\n\n\n\n<div class=\"wp-block-group is-nowrap is-layout-flex wp-container-core-group-is-layout-ad2f72ca wp-block-group-is-layout-flex\">\n<p>Text size is another way to make your Help content look good. Choose a consistent size for headings and body text.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img decoding=\"async\" src=\"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/3.2-3-image.png\" alt=\"\" style=\"width:380px;height:auto\"\/><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-block-group is-nowrap is-layout-flex wp-container-core-group-is-layout-ad2f72ca wp-block-group-is-layout-flex\">\n<p>Spacing is a very important aspect of chunking your information. You need to have white space to create your chunks. There are three types of white space to keep in mind: margins, line spacing and paragraph spacing.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img decoding=\"async\" src=\"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/3.2-3b-image.png\" alt=\"\" style=\"width:371px;height:auto\"\/><\/figure>\n<\/div>\n\n\n\n<p>Group related content together by spacing them closer together. And create chunks by including more space before and after the chunk.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-make-a-style-guide\"><strong>Make a Style Guide<\/strong><\/h3>\n\n\n\n<p>Depending on the tool you are using for publishing and\/or hosting your Help content, you may not need to make many decisions about any of these formatting concerns. But if you aren&#8217;t using the default, you will want to create a quick style guide &#8211; even if it&#8217;s only for your own use &#8211; so you can remember or communicate with others on your team about what decision you made for each element.<\/p>\n\n\n\n<p>To make your Help look good, keep it simple and stay consistent.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Summary<\/h4>\n\n\n\n<p><a href=\"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/Style_Guide_E87qK09.pdf\">Here&#8217;s a sample style guide to use as a template<\/a> for creating your own record of the styles you are using.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-3-3-showing-is-better-than-telling\">3.3 Showing is Better Than Telling<\/h2>\n\n\n\n<p>As we mentioned when discussing chunks for your topics, images can be an important aspect of your topic that help your reader make sense of your instructions.<\/p>\n\n\n\n<p>\u201cShow, don\u2019t tell\u201d is not just an empty cliche. Our brains actually process visual information in images faster than words.<\/p>\n\n\n\n<p>However, it\u2019s a balancing act. While screen capture images can provide lots of information about a process or procedure for the reader without using much space, they can be used when not really necessary or even overused.<\/p>\n\n\n\n<p>As you are writing your content, you\u2019ll balance the need to use images to inform the reader, with the need for conserving space by keeping your topics concise and uncluttered.<\/p>\n\n\n\n<p>It may be tempting to have an image for every icon or button in a procedure. I&#8217;ve done this before in some cases. But in modern Help publishing tools, having too many images may be difficult to maintain going forward. And even when skimming, readers don\u2019t want to scroll through pages of images with very little differences between them.<\/p>\n\n\n\n<p>When you are writing a procedure, consider where an image will be helpful. If it clarifies or makes a distinction between items in your procedure, include an image. If not much has changed since the last image, or if the procedure is just a few simple steps, you may not need an image.<\/p>\n\n\n\n<p>If your user interface includes quite a bit on one screen, don\u2019t show too much at a time. You can crop the image down to show just enough to give the image context in relation to the text. You can also use annotations, like circles, arrows and\/or numbers to connect the image with the related text.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"600\" height=\"259\" src=\"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/3.3-image.png\" alt=\"Screenshot of Camtasia video editing software interface displaying a timeline with multiple tracks and annotations, along with a properties panel on the right for customizing callouts and other elements.\" class=\"wp-image-304695\" srcset=\"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/3.3-image.png 600w, https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/3.3-image-300x130.png 300w, https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/3.3-image-150x65.png 150w\" sizes=\"auto, (max-width: 600px) 100vw, 600px\" \/><figcaption class=\"wp-element-caption\">Full screen shot vs. cropped and annotated screen shot<\/figcaption><\/figure>\n<\/div>\n\n\n<p>Images don\u2019t need to be full-size to be helpful. However, if you are going to resize them, make sure you scale them&nbsp;<em>proportionally&nbsp;<\/em>so that you retain the image quality.<\/p>\n\n\n\n<p>How you handle screenshots is a topic you will want to include in your style guide. Consider how you want to format your images. Is there a border? What color are the annotations? What size are the images?<\/p>\n\n\n\n<p>You need to find a good flow for your screen capturing process. I often grab images as I&#8217;m writing the steps. But if I&#8217;m creating multiple assets at the same time-like writing Help content and developing related video tutorials at the same time, I might write the steps and come back and add the images later to streamline things for a more efficient process.&nbsp;<\/p>\n\n\n\n<p>Whatever your process, start small, keep it simple, and find the flow that works best for you.<\/p>\n\n\n\n<p>In the next lesson, we\u2019ll look at a typical process for capturing images for Help content.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-3-4-screen-capture-basics\">3.4 Screen Capture Basics<\/h2>\n\n\n\n\t<div class=\"dx-block-wistia-embed\">\n\t\t<script type=\"text\/javascript\" src=\"https:\/\/fast.wistia.com\/embed\/medias\/i9gfmqm9xh.jsonp\" async=\"async\"><\/script>\n\n\t\t<div class=\"wistia_responsive_padding\">\n\t\t\t<div class=\"wistia_responsive_wrapper\">\n\t\t\t\t\t\t\t\t\t<div class=\"wistia_embed wistia_async_i9gfmqm9xh videoFoam=true\">&nbsp;<\/div>\n\t\t\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t<\/div>\n\n\n\n<p>Check out these additional resources:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/www.techsmith.com\/learn\/tutorials\/snagit\/\" target=\"_blank\" rel=\"noreferrer noopener\"><em>Snagit Tutorials<\/em><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/www.techsmith.com\/learn\/certification\/\" target=\"_blank\" rel=\"noreferrer noopener\"><em>Snagit Certification<\/em><\/a><em>\u00a0<\/em><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-3-5-simplified-images-sui\">3.5 Simplified Images (SUI)<\/h2>\n\n\n\n\t<div class=\"dx-block-wistia-embed\">\n\t\t<script type=\"text\/javascript\" src=\"https:\/\/fast.wistia.com\/embed\/medias\/u54gry0mog.jsonp\" async=\"async\"><\/script>\n\n\t\t<div class=\"wistia_responsive_padding\">\n\t\t\t<div class=\"wistia_responsive_wrapper\">\n\t\t\t\t\t\t\t\t\t<div class=\"wistia_embed wistia_async_u54gry0mog videoFoam=true\">&nbsp;<\/div>\n\t\t\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t<\/div>\n\n\n\n<p>Check out these additional resources:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/www.techsmith.com\/blog\/simplified-user-interface\/\" target=\"_blank\" rel=\"noreferrer noopener\"><em>Simplified User Interface: the Beginner\u2019s Guide<\/em><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/www.techsmith.com\/blog\/help-content-myths\/\" target=\"_blank\" rel=\"noreferrer noopener\"><em>How to Create a Training Manual<\/em><\/a><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-3-6-animated-gifs\">3.6 Animated GIFs<\/h2>\n\n\n\n\t<div class=\"dx-block-wistia-embed\">\n\t\t<script type=\"text\/javascript\" src=\"https:\/\/fast.wistia.com\/embed\/medias\/lym8ksypp2.jsonp\" async=\"async\"><\/script>\n\n\t\t<div class=\"wistia_responsive_padding\">\n\t\t\t<div class=\"wistia_responsive_wrapper\">\n\t\t\t\t\t\t\t\t\t<div class=\"wistia_embed wistia_async_lym8ksypp2 videoFoam=true\">&nbsp;<\/div>\n\t\t\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t<\/div>\n\n\n\n<p>Check out these additional resources:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/www.techsmith.com\/blog\/use-gif-at-work\/\" target=\"_blank\" rel=\"noreferrer noopener\"><em>The Guide to Using GIFs in the Workplace<\/em><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/youtu.be\/iL3cUSOIEl4\" target=\"_blank\" rel=\"noreferrer noopener\"><em>Animated GIFs<\/em><\/a><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-3-7-how-to-videos\">3.7 How-To Videos<\/h2>\n\n\n\n\t<div class=\"dx-block-wistia-embed\">\n\t\t<script type=\"text\/javascript\" src=\"https:\/\/fast.wistia.com\/embed\/medias\/zt8ouxzi5g.jsonp\" async=\"async\"><\/script>\n\n\t\t<div class=\"wistia_responsive_padding\">\n\t\t\t<div class=\"wistia_responsive_wrapper\">\n\t\t\t\t\t\t\t\t\t<div class=\"wistia_embed wistia_async_zt8ouxzi5g videoFoam=true\">&nbsp;<\/div>\n\t\t\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t<\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-3-8-make-it-look-good-summary\">3.8 Make it Look Good Summary<\/h2>\n\n\n\n<p>To make sure your content looks good and is easy to read:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Keep fonts and styles simple and consistent.<\/li>\n\n\n\n<li>Find a balance for images: not too many, not too few.<\/li>\n\n\n\n<li>Size images proportionally, and crop if needed.<\/li>\n\n\n\n<li>Use simplified images, animated GIFs and how-to videos as needed.<\/li>\n<\/ul>\n\n\n\n<h1 class=\"wp-block-heading\" id=\"h-making-it-easy-to-find\">Making It Easy to Find<\/h1>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-4-1-introduction\">4.1 Introduction<\/h2>\n\n\n\n\t<div class=\"dx-block-wistia-embed\">\n\t\t<script type=\"text\/javascript\" src=\"https:\/\/fast.wistia.com\/embed\/medias\/hbasd9r6ct.jsonp\" async=\"async\"><\/script>\n\n\t\t<div class=\"wistia_responsive_padding\">\n\t\t\t<div class=\"wistia_responsive_wrapper\">\n\t\t\t\t\t\t\t\t\t<div class=\"wistia_embed wistia_async_hbasd9r6ct videoFoam=true\">&nbsp;<\/div>\n\t\t\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t<\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-4-2-cover-tasks-not-functions\">4.2 Cover Tasks, Not Functions<\/h2>\n\n\n\n\t<div class=\"dx-block-wistia-embed\">\n\t\t<script type=\"text\/javascript\" src=\"https:\/\/fast.wistia.com\/embed\/medias\/10fic85xkv.jsonp\" async=\"async\"><\/script>\n\n\t\t<div class=\"wistia_responsive_padding\">\n\t\t\t<div class=\"wistia_responsive_wrapper\">\n\t\t\t\t\t\t\t\t\t<div class=\"wistia_embed wistia_async_10fic85xkv videoFoam=true\">&nbsp;<\/div>\n\t\t\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t<\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-4-3-connect-everything-with-hyperlinks\">4.3 Connect Everything with Hyperlinks<\/h2>\n\n\n\n\t<div class=\"dx-block-wistia-embed\">\n\t\t<script type=\"text\/javascript\" src=\"https:\/\/fast.wistia.com\/embed\/medias\/eqy9at2woy.jsonp\" async=\"async\"><\/script>\n\n\t\t<div class=\"wistia_responsive_padding\">\n\t\t\t<div class=\"wistia_responsive_wrapper\">\n\t\t\t\t\t\t\t\t\t<div class=\"wistia_embed wistia_async_eqy9at2woy videoFoam=true\">&nbsp;<\/div>\n\t\t\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t<\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-4-4-a-word-about-authoring-and-publishing-tools\">4.4 A Word About Authoring and Publishing Tools<\/h2>\n\n\n\n<p>If you are just getting started with developing a Help center, you may also be facing decisions on which authoring and\/or publishing tools or platforms to use. There are many popular solutions to help you build and host your self-service content.<\/p>\n\n\n\n<p>I recommend that you first start planning your center and writing at least a few topics before trying to pick a new tool. Keep your goal in mind as you evaluate different solutions. Try to determine how those solutions might grow along with your company.<\/p>\n\n\n\n<p>I also recommend that you evaluate the options BOTH from the author\u2019s and the reader\u2019s perspective.<\/p>\n\n\n\n<p>From the author\u2019s perspective, consider how easy it is to add images, videos, and links to other topics. How many levels of categories can you use in your structure? How easy is it to format your text? I\u2019ve used some solutions that do not make these tasks easy. If it\u2019s not easy to provide helpful content, chances are what you provide won\u2019t be that helpful.<\/p>\n\n\n\n<p>From the production perspective, you\u2019ll also need to consider the process. Will one person be creating the content, or will you be sourcing articles from many authors, such as your support reps? Consider the workflow for sourcing, editing and publishing articles if necessary.<\/p>\n\n\n\n<p>You might also consider whether you can brand the help center to look like your other resources.<\/p>\n\n\n\n<p>A reader, on the other hand, primarily wants it to be super easy to find the information they need. You might eventually consider more advanced options, like putting the helpful content in-product. But make sure it\u2019s easy for the reader to find out what they need to know or you may as well not have created the content in the first place.<\/p>\n\n\n\n<p>If you have a tool that\u2019s not perfect, don\u2019t let that stop you. You might need to find some creative work-arounds to implement some of the suggestions in this course.<\/p>\n\n\n\n<p>But no matter which authoring tool or publishing platform you end up using, the principles of deciding what to write, how to make it look good, and how to make it easy to find will guide you in writing helpful help.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-4-5-apply-seo-techniques\">4.5 Apply SEO Techniques<\/h2>\n\n\n\n<p>Most people these days are going to their favorite search engine to find out what they need to know.<\/p>\n\n\n\n<p>Readers only spend a few seconds typing in a search term and reviewing the results, so your goal is to have your content show near the top of the page when your readers need your help.<\/p>\n\n\n\n<p>Ideally, the content might even be used as a Feature Snippet, which is a summarized answer from an organic search result. A Feature Snippet is the search engine\u2019s attempt to answer the question so the reader doesn\u2019t even have to leave the search results page.<\/p>\n\n\n\n<p>If your content isn\u2019t at or very near the top of the search results page, your content may be competing with answers that aren\u2019t quite right for the readers you want to help. If the top results include content you don\u2019t control, the answers could be wrong or at least of questionable value.<\/p>\n\n\n\n<p>Or worse, you might be competing with a similar solution from a competitor who would also love to solve the reader\u2019s problem with their product.<\/p>\n\n\n\n<p><strong>Search Engine Optimization<\/strong>, or SEO, is the practice of ensuring your content shows up at the top of the results page when your readers search for a topic. The goal of any of your SEO efforts should be the same as the goal for your content itself: to help your readers succeed.<\/p>\n\n\n\n<p>There are Webmaster Guidelines (<a href=\"https:\/\/support.google.com\/webmasters\/answer\/7451184?hl=en\" target=\"_blank\" rel=\"noreferrer noopener\">sample here<\/a>) for the various search engines, which all include some basic principles and things to avoid when trying to optimize your content in search engine results.&nbsp;<\/p>\n\n\n\n<p>The basic premise is to provide your readers with a great experience that answers their questions, while avoiding any efforts to trick the search engines.<\/p>\n\n\n\n<p>An overarching guideline for SEO is simply to create the best content on the Internet for that particular topic. No pressure, right?<\/p>\n\n\n\n<p>However, you\u2019ll see that many of the concepts we\u2019ve already covered in this course address SEO by making for a better reader experience.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>By chunking your topics to make them more scannable by human readers, you also make them more scannable by search engine crawlers.&nbsp;<\/li>\n\n\n\n<li>Focused, clear topics (especially procedures) are more likely to be read by the search algorithm as a summarized answer to show as a Feature Snippet on a Search Results page.<\/li>\n\n\n\n<li>Using proper formatting, including heading tags, helps search engines emphasize important text.<\/li>\n\n\n\n<li>Images in your help content (especially with ALT text added) helps the search engine crawlers index your content.<\/li>\n\n\n\n<li>Adding hyperlinks back to a topic after it\u2019s published is a small way to make a big impact on how content ranks. These links signify to search engines that a topic is important and popular.<\/li>\n<\/ul>\n\n\n\n<p>There are few other techniques specific to publishing your content that can help your SEO efforts.<\/p>\n\n\n\n<p>While&nbsp;<strong>titles&nbsp;<\/strong>are a very important aspect of helping to find your content, the search engines are also going to look at the&nbsp;<strong>URLs&nbsp;<\/strong>for where your content lives.<\/p>\n\n\n\n<p>Hopefully, your help center platform will let you modify those URLs. If so, you\u2019ll want to make sure a word representing the main idea of your topic is in the URL. But you\u2019ll also want to keep the URL short and focused. And if possible, you\u2019ll want to use readable words in the URL rather than numbers or codes.<\/p>\n\n\n\n<div class=\"wp-block-group is-nowrap is-layout-flex wp-container-core-group-is-layout-ad2f72ca wp-block-group-is-layout-flex\">\n<p>There are two additional SEO strategies that use the HTML coding behind the scenes of your Help content.  One is the Title tag, which is the text that for the reader, only shows at the top of the browser on the tab. You&#8217;ll want to first make sure that every page has a unique title captured in that HTML Title tag.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img decoding=\"async\" src=\"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/4.5-image.png\" alt=\"\" style=\"width:399px;height:auto\"\/><\/figure>\n<\/div>\n\n\n\n<p>And you want to make sure that Title text accurately describes the page&#8217;s content.<\/p>\n\n\n\n<p>The second strategy is to carefully craft the text you include as the&nbsp;<strong>HTML Meta description<\/strong>.<\/p>\n\n\n\n<div class=\"wp-block-group is-nowrap is-layout-flex wp-container-core-group-is-layout-ad2f72ca wp-block-group-is-layout-flex\">\n<p>Think of this text like an advertisement for the page. The meta description doesn&#8217;t show anywhere in the article itself (although it might duplicate content in the article. It&#8217;s present in the HTML coding, and it shows on the Search Results page. You&#8217;ll want to use that description to clearly summarize the page content and convince readers that the page answers their question.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img decoding=\"async\" src=\"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/4.5-2-image.png\" alt=\"\" style=\"width:346px;height:auto\"\/><\/figure>\n<\/div>\n\n\n\n<p>You don\u2019t need to overthink your SEO efforts. Search engines are usually going to rank content written by a company about its own product higher than content published by others. So focus on the other aspects of writing helpful help and you\u2019ll find you\u2019ve already done most of the work needed to make it show up on search results pages.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Summary<\/h4>\n\n\n\n<p>Check out these additional resources:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/support.google.com\/webmasters\/answer\/7451184?hl=en\" target=\"_blank\" rel=\"noreferrer noopener\"><em>Google Webmaster guidelines<\/em><\/a><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-4-6-a-sample-search-for-information\">4.6 A Sample Search for Information<\/h2>\n\n\n\n\t<div class=\"dx-block-wistia-embed\">\n\t\t<script type=\"text\/javascript\" src=\"https:\/\/fast.wistia.com\/embed\/medias\/c8vzk31loo.jsonp\" async=\"async\"><\/script>\n\n\t\t<div class=\"wistia_responsive_padding\">\n\t\t\t<div class=\"wistia_responsive_wrapper\">\n\t\t\t\t\t\t\t\t\t<div class=\"wistia_embed wistia_async_c8vzk31loo videoFoam=true\">&nbsp;<\/div>\n\t\t\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t<\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-4-7-make-it-easy-to-find-summary\">4.7 Make it Easy to Find Summary<\/h2>\n\n\n\n<p>When writing and organizing content for your Help center:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Remember to consider what the reader wants to DO for topic focus and organization.<\/li>\n\n\n\n<li>Use relevant categories to help organizing your content.<\/li>\n\n\n\n<li>Take advantage of hyperlinks to connect related information and keep the number of topics in categories manageable.<\/li>\n\n\n\n<li>Consider the pros and cons of authoring and publishing tools from both the authoring and reading perspectives.<\/li>\n\n\n\n<li>Search engines are looking for many of the same things that make content helpful for human readers.<\/li>\n<\/ul>\n\n\n\n<h1 class=\"wp-block-heading\" id=\"h-conclusion-0\">Conclusion<\/h1>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-writing-your-help\">Writing Your Help<\/h2>\n\n\n\n<p>As you are deciding what to write, making it look good, and making it easy to find, try not to get overwhelmed. The great thing about Help content is that starting anywhere is better than waiting for perfection. And it&#8217;s a project that lends itself well to making a regular schedule for adding new content or making improvements to existing content.<\/p>\n\n\n\n<p>You can also iterate to make improvements as you get feedback. Use the goal you originally set to define metrics that make sense for your business, and then track the effectiveness of your content using those metrics over time to see what is working and what needs improvement.<\/p>\n\n\n\n<p>Good luck!<\/p>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Michele Wiedemer of&nbsp;Virtual Customer Learning&nbsp;has been helping companies create how-to resources for their customers for over 20 years. In this course, she shares her expertise in providing content that helps customers help themselves. This course looks at Michele&#8217;s three principles for creating effective Help center content: 1.1 Introduction Connect with Michele at:&nbsp;https:\/\/linkedin.com\/in\/michele-wiedemer 1.2 What is [&hellip;]<\/p>\n","protected":false},"author":80,"featured_media":304728,"template":"single-tutorial-redesign.php","tcategory":[1909],"ttag":[],"tutorial_folder":[],"class_list":["post-304612","tutorial","type-tutorial","status-publish","has-post-thumbnail","hentry","tcategory-featured-creator-courses"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v23.4 (Yoast SEO v27.5) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>Writing Helpful Help | TechSmith Academy<\/title>\n<meta name=\"description\" content=\"Create effective Help center content using Michele\u2019s expert strategies\u2014set clear goals, format for clarity, and boost discoverability with SEO.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.techsmith.com\/learn\/tutorials\/academy\/writing-helpful-help\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Writing Helpful Help | TechSmith Academy\" \/>\n<meta property=\"og:description\" content=\"Create effective Help center content using Michele\u2019s expert strategies\u2014set clear goals, format for clarity, and boost discoverability with SEO.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.techsmith.com\/learn\/tutorials\/academy\/writing-helpful-help\/\" \/>\n<meta property=\"og:site_name\" content=\"TechSmith Learn\" \/>\n<meta property=\"article:modified_time\" content=\"2025-06-03T12:27:13+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/MichelleWeidemer.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1920\" \/>\n\t<meta property=\"og:image:height\" content=\"1080\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:title\" content=\"Writing Helpful Help | TechSmith Academy\" \/>\n<meta name=\"twitter:description\" content=\"Create effective Help center content using Michele\u2019s expert strategies\u2014set clear goals, format for clarity, and boost discoverability with SEO.\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"19 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/tutorials\\\/academy\\\/writing-helpful-help\\\/\",\"url\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/tutorials\\\/academy\\\/writing-helpful-help\\\/\",\"name\":\"Writing Helpful Help | TechSmith Academy\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/tutorials\\\/academy\\\/writing-helpful-help\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/tutorials\\\/academy\\\/writing-helpful-help\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/wp-content\\\/uploads\\\/2024\\\/12\\\/MichelleWeidemer.png\",\"datePublished\":\"2024-12-30T13:30:00+00:00\",\"dateModified\":\"2025-06-03T12:27:13+00:00\",\"description\":\"Create effective Help center content using Michele\u2019s expert strategies\u2014set clear goals, format for clarity, and boost discoverability with SEO.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/tutorials\\\/academy\\\/writing-helpful-help\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/tutorials\\\/academy\\\/writing-helpful-help\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/tutorials\\\/academy\\\/writing-helpful-help\\\/#primaryimage\",\"url\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/wp-content\\\/uploads\\\/2024\\\/12\\\/MichelleWeidemer.png\",\"contentUrl\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/wp-content\\\/uploads\\\/2024\\\/12\\\/MichelleWeidemer.png\",\"width\":1920,\"height\":1080,\"caption\":\"Split-screen design with a yellow background and an icon of a speech bubble with a question mark and a hand pointing on the left, paired with a woman wearing glasses and a purple shirt on the right, set against a light gray background with geometric patterns.\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/tutorials\\\/academy\\\/writing-helpful-help\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"All Tutorials\",\"item\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/tutorials\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Academy\",\"item\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/tutorials\\\/academy\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Writing Helpful Help\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/#website\",\"url\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/\",\"name\":\"TechSmith Learn\",\"description\":\"Show What You Know\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/#organization\",\"name\":\"TechSmith Corporation\",\"url\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/wp-content\\\/uploads\\\/2021\\\/09\\\/techsmith-logo.png\",\"contentUrl\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/wp-content\\\/uploads\\\/2021\\\/09\\\/techsmith-logo.png\",\"width\":1307,\"height\":390,\"caption\":\"TechSmith Corporation\"},\"image\":{\"@id\":\"https:\\\/\\\/www.techsmith.com\\\/learn\\\/#\\\/schema\\\/logo\\\/image\\\/\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Writing Helpful Help | TechSmith Academy","description":"Create effective Help center content using Michele\u2019s expert strategies\u2014set clear goals, format for clarity, and boost discoverability with SEO.","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:\/\/www.techsmith.com\/learn\/tutorials\/academy\/writing-helpful-help\/","og_locale":"en_US","og_type":"article","og_title":"Writing Helpful Help | TechSmith Academy","og_description":"Create effective Help center content using Michele\u2019s expert strategies\u2014set clear goals, format for clarity, and boost discoverability with SEO.","og_url":"https:\/\/www.techsmith.com\/learn\/tutorials\/academy\/writing-helpful-help\/","og_site_name":"TechSmith Learn","article_modified_time":"2025-06-03T12:27:13+00:00","og_image":[{"width":1920,"height":1080,"url":"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/MichelleWeidemer.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_title":"Writing Helpful Help | TechSmith Academy","twitter_description":"Create effective Help center content using Michele\u2019s expert strategies\u2014set clear goals, format for clarity, and boost discoverability with SEO.","twitter_misc":{"Est. reading time":"19 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.techsmith.com\/learn\/tutorials\/academy\/writing-helpful-help\/","url":"https:\/\/www.techsmith.com\/learn\/tutorials\/academy\/writing-helpful-help\/","name":"Writing Helpful Help | TechSmith Academy","isPartOf":{"@id":"https:\/\/www.techsmith.com\/learn\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.techsmith.com\/learn\/tutorials\/academy\/writing-helpful-help\/#primaryimage"},"image":{"@id":"https:\/\/www.techsmith.com\/learn\/tutorials\/academy\/writing-helpful-help\/#primaryimage"},"thumbnailUrl":"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/MichelleWeidemer.png","datePublished":"2024-12-30T13:30:00+00:00","dateModified":"2025-06-03T12:27:13+00:00","description":"Create effective Help center content using Michele\u2019s expert strategies\u2014set clear goals, format for clarity, and boost discoverability with SEO.","breadcrumb":{"@id":"https:\/\/www.techsmith.com\/learn\/tutorials\/academy\/writing-helpful-help\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.techsmith.com\/learn\/tutorials\/academy\/writing-helpful-help\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.techsmith.com\/learn\/tutorials\/academy\/writing-helpful-help\/#primaryimage","url":"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/MichelleWeidemer.png","contentUrl":"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2024\/12\/MichelleWeidemer.png","width":1920,"height":1080,"caption":"Split-screen design with a yellow background and an icon of a speech bubble with a question mark and a hand pointing on the left, paired with a woman wearing glasses and a purple shirt on the right, set against a light gray background with geometric patterns."},{"@type":"BreadcrumbList","@id":"https:\/\/www.techsmith.com\/learn\/tutorials\/academy\/writing-helpful-help\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"All Tutorials","item":"https:\/\/www.techsmith.com\/learn\/tutorials"},{"@type":"ListItem","position":2,"name":"Academy","item":"https:\/\/www.techsmith.com\/learn\/tutorials\/academy"},{"@type":"ListItem","position":3,"name":"Writing Helpful Help"}]},{"@type":"WebSite","@id":"https:\/\/www.techsmith.com\/learn\/#website","url":"https:\/\/www.techsmith.com\/learn\/","name":"TechSmith Learn","description":"Show What You Know","publisher":{"@id":"https:\/\/www.techsmith.com\/learn\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.techsmith.com\/learn\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.techsmith.com\/learn\/#organization","name":"TechSmith Corporation","url":"https:\/\/www.techsmith.com\/learn\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.techsmith.com\/learn\/#\/schema\/logo\/image\/","url":"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2021\/09\/techsmith-logo.png","contentUrl":"https:\/\/www.techsmith.com\/learn\/wp-content\/uploads\/2021\/09\/techsmith-logo.png","width":1307,"height":390,"caption":"TechSmith Corporation"},"image":{"@id":"https:\/\/www.techsmith.com\/learn\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/www.techsmith.com\/learn\/wp-json\/wp\/v2\/tutorial\/304612","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.techsmith.com\/learn\/wp-json\/wp\/v2\/tutorial"}],"about":[{"href":"https:\/\/www.techsmith.com\/learn\/wp-json\/wp\/v2\/types\/tutorial"}],"author":[{"embeddable":true,"href":"https:\/\/www.techsmith.com\/learn\/wp-json\/wp\/v2\/users\/80"}],"version-history":[{"count":3,"href":"https:\/\/www.techsmith.com\/learn\/wp-json\/wp\/v2\/tutorial\/304612\/revisions"}],"predecessor-version":[{"id":328942,"href":"https:\/\/www.techsmith.com\/learn\/wp-json\/wp\/v2\/tutorial\/304612\/revisions\/328942"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.techsmith.com\/learn\/wp-json\/wp\/v2\/media\/304728"}],"wp:attachment":[{"href":"https:\/\/www.techsmith.com\/learn\/wp-json\/wp\/v2\/media?parent=304612"}],"wp:term":[{"taxonomy":"tcategory","embeddable":true,"href":"https:\/\/www.techsmith.com\/learn\/wp-json\/wp\/v2\/tcategory?post=304612"},{"taxonomy":"ttag","embeddable":true,"href":"https:\/\/www.techsmith.com\/learn\/wp-json\/wp\/v2\/ttag?post=304612"},{"taxonomy":"tutorial_folder","embeddable":true,"href":"https:\/\/www.techsmith.com\/learn\/wp-json\/wp\/v2\/tutorial_folder?post=304612"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}