Technical writers rely on hyperlinks to organize and reference multiple parts of their printed user manuals, eBooks or help files. Making sure hyperlinks are up to date is very important as broken hyperlinks can disrupt the learning flow of the end-user, who might be overwhelmed as she couldn’t find the information needed: this can lead to increased support costs if a support ticket is opened. Thankfully, the HelpNDoc help authoring tool includes a straightforward hyperlink analyzer to help technical writers quickly spot and fix problematic hyperlinks.
Find problematic hyperlinks in your documentation project
HelpNDoc includes a very powerful project analyzer which can assist technical writers by checking the consistency of their documentation projects, such as broken hyperlinks or media elements.
While working on a documentation project, click “Analyze project” from HelpNDoc’s “Home” ribbon tab to access the project analyzer. Every hyperlinks found in that project are listed in the “Hyperlinks” tab, with a description of their location, action… To quickly locate and fix broken hyperlinks, simply:
- Click “Filter…” then “Show broken items only” to only show the broken ones
- Double-click on a row to select the problematic hyperlink in HelpNDoc’s topic editor
- Use HelpNDoc’s hyperlink editor to update the link
Hit the “Refresh” button to make sure that everything is OK, and voilà! It only took a few seconds to correct all the problematic hyperlinks and feel confident about the consistency of your documentation project.
You can now concentrate on the most important part: writing great documentation and help files.
Export the list of hyperlinks to PDF or Excel spreadsheets
A second opinion might be required to make sure that all links are pointing to the correct topics. Once again, HelpNDoc’s project analyzer can help by exporting the list to PDF or Excel.
Why stop there when you can do more: HelpNDoc’s project analyzer has recently been improved to export its content to PDF documents or Excel spreadsheets. This can be useful to create an archive of all hyperlinks in your project, or meticulously inspect them using a third party tool such as Microsoft Excel, or send them to your boss or co-worker for clarification… HelpNDoc’s project analyzer really is an incredible documentation assistant.
Try it now!
Did you know that the HelpNDoc help authoring tool is free and fully functional for personal use and evaluation purposes ? Download your copy now to try it for yourself and see how this powerful software can help you write the most amazing help files, eBooks, user manuals and documentations!
See also...
Mastering Content Updates with HelpNDoc's Search and Replace Tools for Technical Writers
Are you tired of the constant struggle to keep documentation consistent, up-to-date, and error-free? For technical writers and content authors, managing these challenges can be a daunting task. …
Read More →
Transform Your Classroom with HelpNDoc: The Ultimate Back-to-School Tool for Teachers and Students
As the back-to-school season approaches, educators and students are on the lookout for tools that can simplify content creation, improve collaboration, and enhance the overall learning experience. One …
Read More →
How to Customize the Initial Position and Size of CHM Help Files
Creating CHM (Compiled HTML Help) files with HelpNDoc is a breeze, thanks to its user-friendly interface and powerful features. In this article we’ll look into the specifics of how you can set the …
Read More →
Balancing Security and Usability: Best Documentation Formats for Internal Sharing
Sharing documentation effectively and securely is critical in the modern workplace. Whether you’re distributing internal manuals, project documentation, or company policies, the HelpNDoc help …
Read More →