docs: fix broken and incorrect links in documentation#14587
Merged
Conversation
Co-authored-by: labo-flg <146674147+labo-flg@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Fix broken links in documentation build
docs: fix broken and incorrect links in documentation
Feb 24, 2026
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.
MkDocs build emits multiple WARNINGs and INFOs due to broken relative links, missing target files, and absolute links that should be relative.
Changes
administration/enterprise.md— Remove link to non-existentauthetication-in-gui.md(typo + file never created); keep as plain textdeployment/breaking-changes.md— Remove link to non-existentauthentication-in-gui.md; keep as plain textdeployment/integration-manager.md— Remove bullet pointing to non-existentintegration-manager/security.mddevelopment/integration-manager.md— Replace../CONTRIBUTING.md(outside docs tree) with the absolute GitHub URLusage/dashboards.md— Replace absolute/administration/hub/with relative../administration/hub.mdusage/indicators-lifecycle.md— Replace unresolved../deduplicationwithdeduplication.mdusage/import/csv-feed.md— Replace absolute/administration/hub/with relative../../administration/hub.mdOriginal prompt
Problem
The documentation build produces several WARNINGs and INFOs about broken or incorrect links. All of these need to be fixed so the documentation builds cleanly.
Root Cause Analysis
After inspecting all the affected files:
docs/docs/administration/enterprise.mdline 86: Link../deployment/authetication-in-gui.md— The filedocs/docs/deployment/authentication-in-gui.mddoes not exist. This is a typo + the file is missing. Sincedeployment/authentication-in-gui.mddoesn't exist at all in the repo, the link target should be removed or pointed to an existing file. The closest existing file related to authentication is in the deployment section. The link should be updated to point to../deployment/configuration.mdor the link text should be made into a dead-end external reference. Actually, since the file doesn't exist yet, the safest fix is to remove the hyperlink and keep it as plain text, OR link to the closest existing related page. Given the context ("For more information, please read Authentication via GUI configuration"), if the target file doesn't exist, we should remove the link but keep the description text, or link to the authentication page in the breaking-changes. The best approach is to link to../deployment/breaking-changes.md#SSO-update-licensewhich covers that topic.docs/docs/deployment/breaking-changes.mdline 34: Linkauthentication-in-gui.md— Same missing file. Change tobreaking-changes/7.260224.0-SSO-authentication-migration.mdwhich is mentioned right next to it and is a related existing document (or just remove the second link if the file doesn't exist). Since the filedeployment/authentication-in-gui.mddoes not exist, this link should be removed or changed to a valid target. The safest approach is to remove the dangling hyperlink portion and keep the text inline.docs/docs/deployment/integration-manager.mdline 18: Linkintegration-manager/security.md— The filedocs/docs/deployment/integration-manager/security.mddoes not exist in the repo (confirmed by listing the directory). Remove this bullet point entry entirely, or if there is no security doc, remove the link from the list.docs/docs/development/integration-manager.mdline 334: Link../CONTRIBUTING.md— The filedocs/docs/CONTRIBUTING.mddoes not exist. The repo rootCONTRIBUTING.mdis outside thedocs/docs/tree and is not part of the mkdocs documentation. This link should be updated to point to the actual CONTRIBUTING.md on GitHub:https://github.com/OpenCTI-Platform/opencti/blob/master/CONTRIBUTING.mddocs/docs/usage/dashboards.mdline 134: Absolute link/administration/hub/— should be changed to the relative../administration/hub.mddocs/docs/usage/indicators-lifecycle.mdline 50: Unrecognized relative link../deduplication— The filedocs/docs/usage/deduplication.mddoes exist. The link should bededuplication.md(since both files are in the sameusage/directory, or keep../usage/deduplication.mdif writing fromusage/— since they're in the same folder, usededuplication.md).docs/docs/usage/import/csv-feed.mdline 105: Absolute link/administration/hub/— should be changed to the relative../../administration/hub.mdRequired Changes
1.
docs/docs/administration/enterprise.md[Authentication via GUI configuration](../deployment/authetication-in-gui.md)to plain text (remove link) since the target file doesn't exist. Replace with:Authentication via GUI configuration2.
docs/docs/deployment/breaking-changes.mdThis pull request was created from Copilot chat.
💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.