{"id":2793,"date":"2020-02-27T04:34:03","date_gmt":"2020-02-27T04:34:03","guid":{"rendered":"https:\/\/blog.hassler.ec\/wp\/?p=2793"},"modified":"2020-02-21T02:38:29","modified_gmt":"2020-02-21T02:38:29","slug":"how-to-choose-a-help-authoring-tool","status":"publish","type":"post","link":"https:\/\/blog.hassler.ec\/wp\/2020\/02\/27\/how-to-choose-a-help-authoring-tool\/","title":{"rendered":"How to Choose a Help Authoring Tool"},"content":{"rendered":"<div class=\"n p\">\n<div class=\"ac ae af ag ah ez aj ak\">\n<div>\n<div id=\"e8fe\" class=\"fa fb cv ay fc b fd fe ff fg fh fi fj fk fl fm fn\"><\/div>\n<\/div>\n<\/div>\n<\/div>\n<div class=\"hy ak\">\n<figure class=\"hz ia ib ic id hy ak paragraph-image\">\n<div class=\"ii r bs ij\">\n<div class=\"ik r\">\n<div class=\"br ie ep t u if ak bk ig ih\"><img loading=\"lazy\" decoding=\"async\" class=\"nj pe ep t u if ak io\" role=\"presentation\" src=\"https:\/\/miro.medium.com\/max\/1350\/0*g-rgo6OSGKtl9dZo\" width=\"1350\" height=\"900\" \/><\/div>\n<\/div>\n<\/div>\n<\/figure>\n<\/div>\n<div class=\"n p\">\n<div class=\"ac ae af ag ah ez aj ak\">\n<p id=\"c41d\" class=\"hg hh cv ay hi b hj hk hl hm hn ho hp hq hr hs ht eu\" data-selectable-paragraph=\"\">Technical writing is more effective when your help authoring tool is professional, but how to find the right tool that will meet all your needs. Here, I provide you with some points that you should pay attention to.<\/p>\n<h1 id=\"45ba\" class=\"ip iq cv ay ax ir fd is ff it iu iv iw ix iy iz ja\" data-selectable-paragraph=\"\">Easy Writing and Editing<\/h1>\n<p id=\"bde6\" class=\"hg hh cv ay hi b hj jb hl jc hn jd hp je hr jf ht eu\" data-selectable-paragraph=\"\">The writing component of a HAT is essential as your main tasks will be writing topics. So, here are features that your future tool should support:<\/p>\n<ul class=\"\">\n<li id=\"78e3\" class=\"hg hh cv ay hi b hj hk hl hm hn ho hp hq hr hs ht jg jh ji\" data-selectable-paragraph=\"\">WYSIWYG editor with table support<\/li>\n<li id=\"9156\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">A table of contents editor<\/li>\n<li id=\"53ff\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">Word import<\/li>\n<li id=\"4767\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">PDF import<\/li>\n<li id=\"bc36\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">A source code editor<\/li>\n<li id=\"8bab\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">Variables<\/li>\n<li id=\"a85d\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">Snippets<\/li>\n<li id=\"323e\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">A conditional text<\/li>\n<li id=\"7628\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">Profiling<\/li>\n<\/ul>\n<h1 id=\"257c\" class=\"ip iq cv ay ax ir fd is ff it iu iv iw ix iy iz ja\" data-selectable-paragraph=\"\">Collaboration<\/h1>\n<p id=\"049b\" class=\"hg hh cv ay hi b hj jb hl jc hn jd hp je hr jf ht eu\" data-selectable-paragraph=\"\">Collaboration is the main part of technical writing as writing itself. Tech writers don\u2019t create content alone, they work with reviewers to make topics more clear and concise. In some teams, tech writers use MS Word, so they have to send documents via emails, and it\u2019s not convenient because your email may be missed. That\u2019s why the best idea is to use a HAT that allows every team member to work in one tool. For example, in ClickHelp, you can just assign your topic to a reviewer, so they can check your content immediately. More info you can read here:\u00a0<a class=\"bv dl hu hv hw hx\" href=\"https:\/\/clickhelp.com\/clickhelp-technical-writing-blog\/clickhelp-features-topic-workflow-and-review\/?utm_source=medium-com&amp;utm_medium=brad-text-link\" target=\"_blank\" rel=\"noopener nofollow noreferrer\">ClickHelp Features \u2014 Topic Workflow and Review.<\/a><\/p>\n<h1 id=\"a783\" class=\"ip iq cv ay ax ir fd is ff it iu iv iw ix iy iz ja\" data-selectable-paragraph=\"\">Navigation and Search<\/h1>\n<p id=\"2b11\" class=\"hg hh cv ay hi b hj jb hl jc hn jd hp je hr jf ht eu\" data-selectable-paragraph=\"\">Easy navigation and search are essential not only for users but also for tech writers themselves. For example, you want to give a link to a topic but you need to find the topic first. The answer is a convenient search.<\/p>\n<p id=\"5af3\" class=\"hg hh cv ay hi b hj hk hl hm hn ho hp hq hr hs ht eu\" data-selectable-paragraph=\"\">So, here is what will make your technical writing process and documentation effective:<\/p>\n<ul class=\"\">\n<li id=\"cb5b\" class=\"hg hh cv ay hi b hj hk hl hm hn ho hp hq hr hs ht jg jh ji\" data-selectable-paragraph=\"\">Context-sensitive help<\/li>\n<li id=\"17b8\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">A Table of contents<\/li>\n<li id=\"e441\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">Breadcrumbs<\/li>\n<li id=\"5c24\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">Hyperlinks within the system (cross-references)<\/li>\n<li id=\"60bb\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">Hyperlinks to resources outside of the system<\/li>\n<li id=\"07b8\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">An automatically-generated list of links to related pages<\/li>\n<li id=\"9f3b\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">Elegant handling of 404 errors for bad links and missing pages<\/li>\n<li id=\"0ccd\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">The master table of contents for all documents<\/li>\n<li id=\"710d\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">Authored index<\/li>\n<\/ul>\n<figure class=\"hz ia ib ic id hy el em paragraph-image\">\n<div class=\"el em jo\">\n<div class=\"ii r bs ij\">\n<div class=\"jp r\">\n<div class=\"br ie ep t u if ak bk ig ih\"><img loading=\"lazy\" decoding=\"async\" class=\"nj pe ep t u if ak io\" role=\"presentation\" src=\"https:\/\/miro.medium.com\/max\/755\/0*XlHz_xO4Nb5g_OSu.png\" width=\"755\" height=\"201\" \/><\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/figure>\n<h1 id=\"e56b\" class=\"ip iq cv ay ax ir fd is ff it iu iv iw ix iy iz ja\" data-selectable-paragraph=\"\">Customer Feedback Features<\/h1>\n<p id=\"696a\" class=\"hg hh cv ay hi b hj jb hl jc hn jd hp je hr jf ht eu\" data-selectable-paragraph=\"\">When documentation is finished, tech writers continue working on topics to improve them. In order to do this, they monitor customer feedback and statistics that\u2019s why your help authoring tool should support the following options:<\/p>\n<ul class=\"\">\n<li id=\"fbc5\" class=\"hg hh cv ay hi b hj hk hl hm hn ho hp hq hr hs ht jg jh ji\" data-selectable-paragraph=\"\">Customer comments<\/li>\n<li id=\"0ee2\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">Page rating<\/li>\n<li id=\"8b05\" class=\"hg hh cv ay hi b hj jj hl jk hn jl hp jm hr jn ht jg jh ji\" data-selectable-paragraph=\"\">Page analytics<\/li>\n<\/ul>\n<h1 id=\"82b1\" class=\"ip iq cv ay ax ir fd is ff it iu iv iw ix iy iz ja\" data-selectable-paragraph=\"\">Accessibility<\/h1>\n<p id=\"2fb0\" class=\"hg hh cv ay hi b hj jb hl jc hn jd hp je hr jf ht eu\" data-selectable-paragraph=\"\">Nowadays, there are two main documents that standardize how modern software and content should look like to make them accessible to a wider range of people with disabilities, including hearing and deafness loss, low vision and blindness, cognitive limitations, learning disabilities, limited movement, speech disabilities, etc. Section 508 and WCAG are those guidelines.<\/p>\n<p id=\"a595\" class=\"hg hh cv ay hi b hj hk hl hm hn ho hp hq hr hs ht eu\" data-selectable-paragraph=\"\">Of course, in some industries and companies, this is not an obligatory point in the selection of a tool, but I think, it\u2019s a kind of indicator that developers are interested in making their product better.<\/p>\n<h1 id=\"d77b\" class=\"ip iq cv ay ax ir fd is ff it iu iv iw ix iy iz ja\" data-selectable-paragraph=\"\">Conclusion<\/h1>\n<p id=\"7d9b\" class=\"hg hh cv ay hi b hj jb hl jc hn jd hp je hr jf ht eu\" data-selectable-paragraph=\"\">Help authoring tools are usually feature-rich since tech writers work on different and difficult projects but I gathered some key points that will definitely help you make the right decision and save your money.<\/p>\n<\/div>\n<\/div>\n<p data-selectable-paragraph=\"\">\n<p data-selectable-paragraph=\"\">\n<p data-selectable-paragraph=\"\">\n<p data-selectable-paragraph=\"\">\n<p data-selectable-paragraph=\"\">Source:<a href=\"https:\/\/medium.com\/level-up-web\/how-to-choose-a-help-authoring-tool-e9f84cab54bf\"> https:\/\/medium.com\/level-up-web\/how-to-choose-a-help-authoring-tool-e9f84cab54bf<\/a><\/p>\n<p data-selectable-paragraph=\"\">\n<div class=\"lu lv r bs\">\n<div class=\"r eo ly lz\"><a href=\"https:\/\/medium.com\/@bradley_nice?source=follow_footer--------------------------follow_footer-\" rel=\"noopener\"><img loading=\"lazy\" decoding=\"async\" class=\"r dn ee ma alignleft\" src=\"https:\/\/miro.medium.com\/fit\/c\/80\/80\/1*y-qasOnzXkeCiQeLfIrPoQ.jpeg\" alt=\"Bradley Nice\" width=\"80\" height=\"80\" \/><\/a><\/div>\n<div class=\"mb r mc\">\n<p class=\"ax gc gu az bc md me\">WRITTEN BY<\/p>\n<\/div>\n<div class=\"mb mf n mc\">\n<div class=\"ak n o ft\">\n<h2 class=\"ax jt iv mg cu\"><a class=\"bv bw bx by bz ca cb cc cd ce cf cg ch ci cj ck\" href=\"https:\/\/medium.com\/@bradley_nice?source=follow_footer--------------------------follow_footer-\" rel=\"noopener\">Bradley Nice<\/a><\/h2>\n<div class=\"r g\"><span style=\"color: inherit; font-family: inherit; font-size: 17.5px; font-weight: bold;\">Content Manager at https:\/\/medium.com\/level-up-web ?. I write about web design, web development and technical writing. Follow me on Twitter and Facebook<\/span><\/div>\n<\/div>\n<\/div>\n<\/div>\n<div class=\"ls r\"><\/div>\n<div><\/div>\n<div class=\"lu lv r bs\">\n<div class=\"r eo ly lz\"><a href=\"https:\/\/medium.com\/level-up-web?source=follow_footer--------------------------follow_footer-\" rel=\"noopener\"><img loading=\"lazy\" decoding=\"async\" class=\"dg ma ee alignleft\" src=\"https:\/\/miro.medium.com\/fit\/c\/80\/80\/1*C_OKNjdlBcTMmZCSk0AEkA.png\" alt=\"Level Up!\" width=\"80\" height=\"80\" \/><\/a><\/div>\n<div class=\"mb mf n mc\">\n<div class=\"ak n o ft\">\n<h2 class=\"ax jt iv mg cu\"><a class=\"bv bw bx by bz ca cb cc cd ce cf cg ch ci cj ck\" href=\"https:\/\/medium.com\/level-up-web?source=follow_footer--------------------------follow_footer-\" rel=\"noopener\">Level Up!<\/a><\/h2>\n<div class=\"r g\">\n<div class=\"bm\" aria-hidden=\"true\"><span style=\"color: inherit; font-family: inherit; font-size: 17.5px; font-weight: bold;\">Stories for technical writers, web developers and web designers. It&#8217;s time to level up your skills!<\/span><\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<div aria-hidden=\"true\"><\/div>\n<div aria-hidden=\"true\"><\/div>\n<div aria-hidden=\"true\"><\/div>\n<p data-selectable-paragraph=\"\">\n<p data-selectable-paragraph=\"\">\n<p data-selectable-paragraph=\"\">\n<p data-selectable-paragraph=\"\">\n<p data-selectable-paragraph=\"\">\n","protected":false},"excerpt":{"rendered":"<p>Technical writing is more effective when your help authoring tool is professional, but how to find the right tool that [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":2795,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[12,128,47,21,40],"tags":[],"class_list":["post-2793","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-bloghassler-ec","category-clickhelp","category-medium","category-productividad","category-technical-writer"],"_links":{"self":[{"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/posts\/2793","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/comments?post=2793"}],"version-history":[{"count":1,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/posts\/2793\/revisions"}],"predecessor-version":[{"id":2796,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/posts\/2793\/revisions\/2796"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/media\/2795"}],"wp:attachment":[{"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/media?parent=2793"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/categories?post=2793"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/tags?post=2793"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}