Search results

ClickHelp -- a flexible online platform for authoring and publishing technical documentation

by Tom Johnson on Jun 8, 2019
categories: technical-writing

Let's say you need to create and publish technical documentation. Maybe you have a team of distributed authors, and you need all the robustness of an advanced tech doc solution, but you don't want to create your own version from scratch. (I've argued in numerous posts that creating your own tools from scratch can require a lot of time and hidden expenses.) Enter ClickHelp. ClickHelp is a flexible, online help authoring solution that offers an impressive number of features, from context-sensitive help to built-in metrics, content re-use, PDF export, full-text search, password protection, full review cycles, readability analysis, and more. In this post, I'll provide brief descriptions and screenshots as we browse through the various features ClickHelp offers.

Note that this is a sponsored post.

Who is using ClickHelp?

Let’s first talk about who is using ClickHelp (because you want to be sure the platform will be around for the long term). ClickHelp has about 25k users across 93 countries. They’ve been in business since 2010 and have been steadily increasing users ever since. Documentation produced with ClickHelp has garnered more than 13 million views, ensuring a wide user base (see Our Vision and Mission). Traditionally, ClickHelp has had wider use in Europe and Asia than North America, but the company is expanding its focus to include more of a U.S.-based audience.

What’s possible with ClickHelp?

ClickHelp offers all the features you’d expect to find in an online help – robust sidebar navigation with expandable/collapsible folders, comprehensive search, custom branding, and more. To get a sense of what’s possible with ClickHelp, check out ClickHelp’s own help.

Typical help authoring process

Also, check out these example ClickHelp sites and customer reviews. As an online platform, authors can use PC, Mac, or Linux. All you need is a browser.

Single-sourcing and content re-use

ClickHelp offers single sourcing and content re-use on par with what technical writers typically need. With ClickHelp, any topic can either be a standalone topic or can be re-used inside other topics. For example, suppose you have a common section used in multiple topics. You would create that common section as a topic and then just drag it into the other topics where you want to re-use it. In the following example, “Rights of Usage” is another topic that has been re-used inside this New Topic.

Content re-use

You can re-use content as small as single sentences or topics many paragraphs long. ClickHelp also supports variables, which you can configure either on a project or global level. For more information, see Single Sourcing Techniques and Content Snippets.

Importing or Exporting Content

With ClickHelp, you can both import and export content in a variety of formats. For example, you can import content into ClickHelp from a Microsoft Word document, HTML, or from CHM. When you import content, you can choose how the topics are broken up based on the heading levels.

Import Project Wizard

You can also export the content to HTML, PDF, Docx, CHM, and more.

Export wizard

ClickHelp uses XHTML as its base format, with other standards such as JS and CSS. In short, your data isn’t trapped in a proprietary format. For more information, see Documentation Import and Documentation Outputs.

ClickHelp offers an innovative full-text search, driven by their own custom-patented search algorithm, for both authors and readers. You can both configure and weight the search with different index keywords. The search algorithm also takes into account the current permissions of the user, scoping the search results to those permissions.

The following screenshot shows how you can define index keywords for a topic that will then be used in search to help that topic surface.

Index keywords with search

You can either search everything or narrow the search to a specific publication. If the same topic is found in multiple places (such as in multiple publications), the search results show just one result and a selector with its multiple versions. The search supports both wildcards, asterisks, fuzzy matching, and boolean operators. Here’s the search featured prominently on a sample ClickHelp site:

Index keywords with search

To help with SEO, ClickHelp even includes sitemaps, verification with google webmaster tools, and Google Analytics built-directly in (if desired). For more information, see Full-text Search.

Content metrics and analytics

ClickHelp provides built-in metrics and analytics about the content. You can generate more than a dozen different reports, such as reports listing doc status (draft, reviewed, published, etc.), content ownership, and custom reports based on other metadata (e.g., topics that haven’t been updated or reviewed, and so on). You can even generate readability scores and analyses of your content. The following screenshot shows a Project Readiness chart on the ClickHelp Portal Dashboard:

Reporting

You can also create reports about the searches run on your portal. You can see what keywords people search for as well as the results returned. You can even see which search results users clicked on for their queries. This lets you know if users were successful or not with their searches. For more information, see Reporting and Analytics and ClickHelp March 2019 Release Overview - Aurora Polaris. (The Readability Analysis report was a feature included in the latest release.)

Document review process

ClickHelp offers a robust review process, also enhanced in their latest release. You can assign a topic to a reviewer. The reviewer can log in with their account and see a special reviewer UI. The reviewer can then highlight text and make annotations in the margins, similar to Google Docs.

Adding comments

Authors can reply to the comments and create conversations in these sidebar threads.

Sidebar conversations

To monitor the progress of topics reviewed, you can see at a glance from the table of contents which topics have been reviewed or which have outstanding comments.

Reviewed topics

You can even add “to-do” items for a topic and see at a glance which topics have these to-do’s. For more details, see Review Workflow and ClickHelp March Release Sneak Peek: Enhanced Review Process. (The review process was one of the major enhancements in the latest release.)

PDF

In addition to web outputs, you can publish your ClickHelp projects as full-featured PDFs, choosing the topics you want included or excluded. The PDFs can include hundreds of topics or just one – it depends how much you want to include in your PDF publication. You can customize headers, footers, and other styles in the PDF through a Word file that acts as a template for the PDF. The following screenshot shows the configuration of heading levels in the PDF export.

Configuring PDF export

For more information, see Create a PDF manual.

Password-protected content

If you need to password protect your content, you can do so through ClickHelp’s user management settings. Your manuals can have both public and password-protected sections, controlled through role-based access. You define roles in the system and then configure which roles have access to which topics. You can then assign users to those roles. You can even control user management through a REST API (which might be helpful if you’re provisioning hundreds of users).

User management and password protection

For more information, see User Management.

Translation

ClickHelp supports translation for any unicode language. For translation projects, you export a project to the format your translation vendor requires (usually HTML or Word). The translation vendor completes the translation, and then you re-import the translated content as a new project in ClickHelp.

Your translated topics can be connected to the other language versions through a version selector, if desired. Additionally, if you want translated docs but don’t want to actually translate your content, ClickHelp lets you add a Google Translate widget to your project. For more information, see Translation.

Custom branding

Custom branding is one of the strong points of ClickHelp. You can define a global stylesheet for the entire portal, targeting the top bar, homepage, login page, and other major elements. You can also define a global JavaScript to change layouts and where elements appear.

Custom branding

Through the JS customization, you can even add your own live chat integration (from an external script) to your documentation site, as you can see any page in Clickhelp’s main site. For more information, see Branding and Styling.

Context-sensitive help

ClickHelp lets you create context-sensitive help to integrate your content into web applications. A special editor lets you convert your topics into a JS-based code snippet that developers can integrate into their applications. The code snippet pulls your content in from ClickHelp – this means if you update the original source in ClickHelp, the context-sensitive instance gets updated as well. The context-sensitive help can include rich text popups that include not only text but also screenshots and videos.

Context-sensitive help

For more information, see ClickHelp Features: Context-sensitive help.

Other features

I’ve only covered a handful of features. ClickHelp just released a ton of enhancements in their latest release – “Aurora Polaris” (which, I have to say, is a cool name for a release). More description of the features in the Aurora Polaris release continues here.

Latest release -- Aurora Polaris

How much does ClickHelp cost?

ClickHelp is relatively inexpensive compared to other tech doc tools. Their most basic plan starts at $43/month, and, for example, for less than 3k/year you will get a ClickHelp Pro plan that includes all features of the tool, 6 authors, unlimited reviewers, and 2000 topics. (see Pricing).

Conclusion

Overall, ClickHelp provides most of the features technical writers look for when evaluating technical documentation platforms. Their platform-agnostic, SaaS-based approach allows ClickHelp to incrementally develop and release new features continuously. Their web-based platform and output give you a lot of flexibility and control to brand and deliver world-class looking help. If you’re looking for a tech doc solution, ClickHelp is definitely worth checking out. You can start a free trial here.

Your feedback and input

Would you mind sharing your feedback on this post by answering the following questions? You can see the ongoing results here.

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.

If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.