Skip to content

docs: Replace symlinks at build time to use markdown link syntax - #113

Merged
chtruong814 merged 1 commit into
mainfrom
chtruong/fix-docs
Mar 13, 2026
Merged

docs: Replace symlinks at build time to use markdown link syntax#113
chtruong814 merged 1 commit into
mainfrom
chtruong/fix-docs

Conversation

@chtruong814

Copy link
Copy Markdown
Contributor

docs: Replace symlinks at build time to use markdown link syntax

For the files that are symlinked into the docs, directory, we had to use sphinx link format to make the references work. However, this can lead to an awkward experience for users that read the docs from the Github repo. To avoid this, we copy the directories and remove the symlink at build time during the CI. And in the repo, we can replace the sphinx link with the markdown link for better readability.

Signed-off-by: Charlie Truong <chtruong@nvidia.com>

- {doc}`nemo-megatron-bridge <nemo-megatron-bridge/README>` — Recipe using [NeMo Megatron-Bridge](https://github.com/NVIDIA-NeMo/Megatron-Bridge)
- {doc}`nemo-automodel <nemo-automodel/README>` — Recipe using [NeMo AutoModel](https://github.com/NVIDIA-NeMo/Automodel)
- [nemo-megatron-bridge](nemo-megatron-bridge/README.md) — Recipe using [NeMo Megatron-Bridge](https://github.com/NVIDIA-NeMo/Megatron-Bridge)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Thanks, is it all possible that it it points to the folder, and not the README.md files ?

@chtruong814
chtruong814 merged commit 1760449 into main Mar 13, 2026
4 checks passed
anniesurla added a commit to anniesurla/Nemotron that referenced this pull request Mar 16, 2026
…DIA-NeMo#113)

Signed-off-by: Charlie Truong <chtruong@nvidia.com>
Signed-off-by: Annie Surla <110621965+anniesurla@users.noreply.github.com>
shashank3959 added a commit that referenced this pull request Mar 17, 2026
… (#118)

Signed-off-by: Charlie Truong <chtruong@nvidia.com>
Signed-off-by: Annie Surla <110621965+anniesurla@users.noreply.github.com>
Co-authored-by: Shashank Verma <shashankv@nvidia.com>
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.

2 participants