Skip to content

doc: rm links to doc source; show links to github code source#1506

Merged
leondz merged 1 commit intoNVIDIA:mainfrom
leondz:docs/link_code_source
Dec 1, 2025
Merged

doc: rm links to doc source; show links to github code source#1506
leondz merged 1 commit intoNVIDIA:mainfrom
leondz:docs/link_code_source

Conversation

@leondz
Copy link
Collaborator

@leondz leondz commented Dec 1, 2025

see title

example in practice:

image

("Source" here links to github / main branch)

@leondz leondz added the documentation Improvements or additions to documentation label Dec 1, 2025
Copy link
Collaborator

@erickgalinkin erickgalinkin left a comment

Choose a reason for hiding this comment

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

LGTM

Copy link
Member

@mikemckiernan mikemckiernan left a comment

Choose a reason for hiding this comment

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

Yeah, copying the source of every file is kind of terrible.

@leondz
Copy link
Collaborator Author

leondz commented Dec 1, 2025

Yeah, copying the source of every file is kind of terrible.

This PR is more of a UX change - the default "view source" link pointed to the source of the RST-fornat documentation, and the change makes it point to the Python source code

Copy link
Collaborator

@jmartin-tech jmartin-tech left a comment

Choose a reason for hiding this comment

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

This seems reasonable, is the project comfortable with local build of the doc source to have possibly invalid links to source? The build process uses the commit hash of the local commit as the resolved permalink and a local build done after local commits that have not been accepted upstream will produce links that 404 when followed.

@leondz
Copy link
Collaborator Author

leondz commented Dec 1, 2025

It's a little smart - it even uses the most recent hash of the file being tested, rather than head, is what I believe was observed in validation

@leondz leondz merged commit ba9c7b5 into NVIDIA:main Dec 1, 2025
19 of 28 checks passed
@github-actions github-actions bot locked and limited conversation to collaborators Dec 1, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants