You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Related to swiftlang/swift-docc#701, it would be nice to have a docc-plugin command, or potentially a build plugin, that could parse HTML links from within DocC content to determine if those links were still valid or not.
When/if Docc emits a digest with all possible links within it, a useful follow-on would be a docc-plugin command to check those links to report which are valid/invalid, with sufficient location information in the output to know where/what file to update.
Motivation:
Early (and still current as of this writing) DocC doesn't have the ability to provide cross-references to modules or symbols in other modules, leading to the common practice of embedding URLs for the reader's convenience. URLs and libraries change, as well as even hosting locations, so URLs aren't always as static as we'd like. Ideally, one could run a process to verify that all external links, at least at a given point in time, are still valid links.
Importance:
This is primarily a quality of life improvement, and an efficiency update to the alternative of crawling all the pages generated with a javascript-aware-and-enabled parsing engine to view the HTML for links, following them, and report on failures.
Alternatives Considered
If you considered alternative approaches for this feature, please include them here.
Feature Request: Dead Link checking command
Description:
Related to swiftlang/swift-docc#701, it would be nice to have a docc-plugin command, or potentially a build plugin, that could parse HTML links from within DocC content to determine if those links were still valid or not.
When/if Docc emits a digest with all possible links within it, a useful follow-on would be a docc-plugin command to check those links to report which are valid/invalid, with sufficient location information in the output to know where/what file to update.
Motivation:
Early (and still current as of this writing) DocC doesn't have the ability to provide cross-references to modules or symbols in other modules, leading to the common practice of embedding URLs for the reader's convenience. URLs and libraries change, as well as even hosting locations, so URLs aren't always as static as we'd like. Ideally, one could run a process to verify that all external links, at least at a given point in time, are still valid links.
Importance:
This is primarily a quality of life improvement, and an efficiency update to the alternative of crawling all the pages generated with a javascript-aware-and-enabled parsing engine to view the HTML for links, following them, and report on failures.
Alternatives Considered
If you considered alternative approaches for this feature, please include them here.
/cc @amartini51
The text was updated successfully, but these errors were encountered: