{"id":2180,"date":"2019-10-22T04:15:56","date_gmt":"2019-10-22T04:15:56","guid":{"rendered":"https:\/\/blog.hassler.ec\/wp\/?p=2180"},"modified":"2019-09-22T12:58:30","modified_gmt":"2019-09-22T12:58:30","slug":"most-demanded-features-in-software-documentation-tools","status":"publish","type":"post","link":"https:\/\/blog.hassler.ec\/wp\/2019\/10\/22\/most-demanded-features-in-software-documentation-tools\/","title":{"rendered":"Most Demanded Features in Software Documentation Tools"},"content":{"rendered":"
\n
\n
\n
<\/div>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
\n
<\/div>\n

\"\"<\/div>\n<\/div>\n<\/div>\n<\/figure>\n<\/div>\n

\n

S<\/span>ince you are visiting our website then you probably know that we create software to help writers. We have years of experience of working with\u00a0techcomm experts<\/a>, so we know what is going on in the industry.<\/p>\n

Being a client-oriented company, we pay a lot of attention to what our users are saying, and, in this post, we are going to share with you some features that are highly demanded by technical writers in a help authoring tool.<\/p>\n

Export\/Import Formats<\/h1>\n

That\u2019s probably the first thing to consider in technical writing software, really. Use cases of moving to new tools are different, but quite often they imply migrating already existing user manuals to this new HAT. And, that process needs to be as painless as possible. First, there should be the very possibility to import documentation stored in a certain format. Second, the help authoring tool needs to be able to understand and preserve the original formatting. These things are vital.<\/p>\n

As far as exporting ready documents is concerned, this is again super important. We believe that a help authoring tool should be sufficient for a technical writing process and scenarios where you need to do extra converting after you received some output from your HAT are a no go.<\/p>\n

Single-Sourcing Techniques<\/h1>\n
\n
\n
\n
\n
<\/div>\n

\"\"<\/div>\n<\/div>\n<\/div>\n<\/figure>\n

Single-sourcing makes maintenance of technical documentation much easier. And this is a must-have for a lot of technical writers who work on big projects. But, actually, any type of project can benefit from single-sourcing this way. Plus, what single-sourcing allows is creating multiple outputs from one original source and that\u2019s another thing people are looking for in a help authoring tool. It is actually a bunch of techniques working together. Learn more about the best practices of using single-sourcing\u00a0here<\/a>.<\/p>\n

Branding and Design<\/h1>\n

Judging a book by its cover is wrong, but covers are still playing their part in our perception of things. Just like we can tell from looking at a book\u2019s cover what genre it is and kind of guess what its content is like, we judge other things.<\/p>\n

We can somehow tell whether a company is trustworthy depending on its corporate website, for example. Sometimes we can\u2019t even say why exactly we feel like this, it just happens to be so subtle. We all have this hunch. This is, for example, what protects us from phishing attacks and other schemes. That\u2019s approximately what we have from a reader\u2019s perspective. For technical writers, this means that things like intuitive branding options and flexible design possibilities have a high priority and need to be included in a help authoring tool so that the final output looks professional and appealing.<\/p>\n

\n
\n
\n
\n
\n
<\/div>\n

\"\"<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/figure>\n

Single Sign-On<\/h1>\n

This is, perhaps, not a go-to feature for some technical writers. If a HAT is missing the SSO option, it is not something that would stop you from using the tool. Given that SSO is not demanded by your company\u2019s security policy, which is also the case sometimes as SSO decreases damage from hack attacks and improves data security. If you want to learn more about this technology, check out our article on\u00a0single sign-on for dummies<\/a>. It explains in simple words its core work principles and how exactly it is so secure. Supporting single sign-on is such a basic thing for us now thanks to Google and Facebook that an online-based documentation tool that doesn\u2019t have it looks pretty weird.<\/p>\n

Analytical Tools<\/h1>\n
\n
\n
\n
\n
<\/div>\n

\"\"<\/div>\n<\/div>\n<\/div>\n<\/figure>\n

Measuring various data allows a deeper understanding of what is going on within a project and how to improve things. While overanalyzing is really bad and we advise against it, you will need to keep track of certain data for sure. Our own tool for help authoring,\u00a0ClickHelp<\/a>, can equip you with dozens of ways to analyze things, and the best way to handle this is by working out a set of criteria to consider and using it to your benefit.<\/p>\n

Conclusion<\/h1>\n

These are some of the highly-demanded features most tech writers would like to see in a technical writing tool. They are only general requirements, of course, but they work for the majority of documentation teams. But, sometimes, we are facing clients with very specific demands dictated by their use case.<\/p>\n<\/div>\n<\/section>\n

\n
\n
\n

What are you looking for in a HAT? Feel free to share!<\/p>\n<\/div>\n<\/section>\n

\n
\n
\n

Good luck with your technical writing!
\nClickHelp Team<\/a>
\nAuthor, host and deliver documentation across platforms and devices<\/p>\n<\/div>\n<\/section>\n

\n

\n

Source: https:\/\/medium.com\/level-up-web\/most-demanded-features-in-software-documentation-tools-bdcfe0d1477a<\/a><\/strong><\/p>\n

Written by<\/strong><\/p>\n

\"ClickHelp\"<\/a>ClickHelp<\/a><\/div>\n
\n
\n

ClickHelp – Professional Online Technical Writing Tool. Check it out: https:\/\/clickhelp.com\/online-documentation-tool\/<\/a><\/h4>\n<\/div>\n<\/div>\n

 <\/p>\n

 <\/p>\n

\n","protected":false},"excerpt":{"rendered":"

Since you are visiting our website then you probably know that we create software to help writers. We have years […]<\/p>\n","protected":false},"author":2,"featured_media":2182,"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,40],"tags":[],"class_list":["post-2180","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-bloghassler-ec","category-clickhelp","category-medium","category-technical-writer"],"_links":{"self":[{"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/posts\/2180","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=2180"}],"version-history":[{"count":1,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/posts\/2180\/revisions"}],"predecessor-version":[{"id":2183,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/posts\/2180\/revisions\/2183"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/media\/2182"}],"wp:attachment":[{"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/media?parent=2180"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/categories?post=2180"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/tags?post=2180"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}