Skip to content

Make all links internal (where possible)#3671

Merged
copybara-service[bot] merged 1 commit into
AI-Hypercomputer:mainfrom
melissawm:fix-links
Jun 18, 2026
Merged

Make all links internal (where possible)#3671
copybara-service[bot] merged 1 commit into
AI-Hypercomputer:mainfrom
melissawm:fix-links

Conversation

@melissawm

Copy link
Copy Markdown
Collaborator

Description

Fixes the issue where links were hardcoded to the latest version of the documentation. This includes creating anchors (such as (checkpoint-conversion)=) and using this anchor when creating a link to that page. In other cases, linking out to the explicit markdown file is appropriate, and a link will be correctly created when the documentation is built for the ReadTheDocs website.

For consistency, all links to internal documentation should be done using internal link syntax; this will guarantee that each build of the documentation is consistent with respect to versioning. One exception is the "Update dependencies" page, where we explicitly want to link out to the latest version of the "Install MaxText" page.

Tests

Docs build correctly locally and links are created as expected.

Checklist

Before submitting this PR, please make sure (put X in square brackets):

  • [N/A] I have performed a self-review of my code. For an optional AI review, add the gemini-review label.
  • [N/A] I have necessary comments in my code, particularly in hard-to-understand areas.
  • [N/A] I have run end-to-end tests tests and provided workload links above if applicable.
  • I have made or will make corresponding changes to the doc if needed, including adding new documentation pages to the relevant Table of Contents (toctree directive) as explained in our documentation.

@melissawm melissawm force-pushed the fix-links branch 3 times, most recently from 9a1e24b to 11cd3f9 Compare June 9, 2026 19:45
@melissawm

Copy link
Copy Markdown
Collaborator Author

@SurbhiJainUSC it would be great if you could help with merging this one too 🙏🏻 thanks!

Comment thread docs/guides/data_input_pipeline.md Outdated
Comment thread docs/guides/optimization.md Outdated
Comment thread docs/run_maxtext/run_maxtext_localhost.md Outdated
Comment thread docs/release_notes.md
Comment thread docs/tutorials/post_training_index.md
@melissawm

Copy link
Copy Markdown
Collaborator Author

Thank you @SurbhiJainUSC - I think something had gone wrong in my previous rebase. All your comments should be addressed now 🙏🏻

@copybara-service copybara-service Bot merged commit 03cabc3 into AI-Hypercomputer:main Jun 18, 2026
34 of 35 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants