Skip to content

Fix failing docs by repairing broken link#5334

Closed
dkytezab wants to merge 1 commit intoCliMA:mainfrom
dkytezab:dkz/fix-docs-build
Closed

Fix failing docs by repairing broken link#5334
dkytezab wants to merge 1 commit intoCliMA:mainfrom
dkytezab:dkz/fix-docs-build

Conversation

@dkytezab
Copy link
Copy Markdown
Collaborator

No description provided.

Copy link
Copy Markdown
Member

@navidcy navidcy left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the real solution is to make the stable link work, not to replace it with the dev version.

@briochemc
Copy link
Copy Markdown
Collaborator

briochemc commented Feb 25, 2026

I think the best solution would be to place an @id tag on the sections being linked to, and then use @ref, that way the links don't make you jump from one version to another?


EDIT: To be clear, I think the stable docs should not 404 of course, but to me that is a different issue, no?

@briochemc
Copy link
Copy Markdown
Collaborator

I tried to do that in #5335.

@giordano
Copy link
Copy Markdown
Collaborator

Yes, I agree #5335 is a better approach, internal references should be handled with @ref, which is more robust in case sections are moved around.

@giordano
Copy link
Copy Markdown
Collaborator

Superseded by #5335.

@giordano giordano closed this Feb 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants