Broken Links MUST ignore external links outside the KB
complete
Shannon Greywalker
The broken links feature is a mission-critical feature for any documentation product like Doc360. Especially if you use extensive intra- and extra-page linking because you follow an "every page is page one (EPPO)" paradigm.
But your current broken links implementation becomes rapidly worthless and untrustworthy if you include ANY links to external sites that are behind some form of security authentication. For example, articles written for our internal developers routinely contain links to our private GitHub Enterprise repos. Because your link crawler cannot authenticate and actually follow these links, all the articles containing such links are reported as containing broken links. When in fact they are not.
This same problem exists when you might link to a design document on a Sharepoint host, or to a privately team-shared Google Sheet, etc. etc.
As a result, we already have a running list of 42 articles with broken links, when in fact no links are broken at all. And it makes it nearly impossible to recognize a TRUE broken link (internal KB links), because of all the NOT broken pages already sitting in the broken links report.
I'd honestly recommend just globally ignoring ALL external links. But if you are worried about doing that, then at the very least, please give us a config option to disable broken link checking for external links, for those of us who might be linking to private hosts in this manner.
Note that a major content platform (MadCap Flare) also has excellent link-checking features, and it completely ignores external links during its link-checking process. That never posed an issue in the 10+ years I worked in a Flare authoring environment.
Log In
D
Document360 Support
complete
D
Document360 Support
Shannon and Everyone: As you might have observed, the option for managing various types of links has been implemented, we are marking this item as "Complete" for now. Please reach us if you have any queries. Thank you!
Glenn Elliott
Out of the hundreds of broken links we have reported perhaps only 2 were actually broken.
Being able to turn off external site checking would be helpful in filtering out some of these, otherwise it's not a useable feature.
JULIE WALLACE
Agree, and commented under a similar ticket that I check broken links once a week and always ignore the links to external sites as they are not broken. https://feedback.document360.com/feature-request/p/broken-links-restricted-sites-being-able-to-change-status
Shannon Greywalker
At the very least, give us a toggle that filters out all external links from the broken links reporting/checking. My main goal with link checking is to ensure that links among articles _within_ our knowledgebase are not broken. This can be _very_ important when we change an article stub and want to ensure that we didn't break links to the article from other articles.
Thiru
under review
Caroline Tabach
I also encountered this issue. "ANY links to external sites that are behind some form of security authentication." On the other hand I would like to see if there are external links which are broken. Maybe you can improve the link checking feature