fix(build): shorten Doxygen titles and noindex generated index pages - #53
Draft
jwrosewell wants to merge 1 commit into
Draft
fix(build): shorten Doxygen titles and noindex generated index pages#53jwrosewell wants to merge 1 commit into
jwrosewell wants to merge 1 commit into
Conversation
Sets FULL_PATH_NAMES = NO so the generated directory and file page titles no longer embed the full CI build path, and enables HTML_INDEX_NOINDEX = YES so Doxygen's generated navigation, index and helper pages (dir_*.html, pages.html, the crawler helper and the graph legend) carry <meta name="robots" content="noindex,follow">. These thin, link-only pages are flagged as low-quality content by search engines. The change keeps them out of the search index while crawlers still follow their links to the real documentation. Part of the SEMrush documentation audit remediation (issues 102, 112, 117). HTML_INDEX_NOINDEX requires the updated 51Degrees DoxyGen build (51Degrees/DoxyGen#7); older builds ignore the tag with a harmless warning.
jwrosewell
marked this pull request as draft
June 14, 2026 18:53
Contributor
Author
|
Setting this to draft so it is not picked up by the overnight auto-merge over the weekend. This is a precaution after an unintended overnight merge last night; nothing here is believed to be broken. It will be marked ready for review when the team is back. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
fix(build): shorten Doxygen titles and noindex generated index pages
Sets FULL_PATH_NAMES = NO so the generated directory and file page titles no
longer embed the full CI build path, and enables HTML_INDEX_NOINDEX = YES so
Doxygen's generated navigation, index and helper pages (dir_*.html, pages.html,
the crawler helper and the graph legend) carry
.
These thin, link-only pages are flagged as low-quality content by search
engines. The change keeps them out of the search index while crawlers still
follow their links to the real documentation. Part of the SEMrush documentation
audit remediation (issues 102, 112, 117).
HTML_INDEX_NOINDEX requires the updated 51Degrees DoxyGen build
(51Degrees/doxygen#7); older builds ignore the tag with a harmless warning.