Fix doc build warnings (toctree extension) and 429 rate limit errors

Author: darisoy

docs/conf.py

@@ -165,6 +165,9 @@
     r"https://github\.com/jax-ml/jax/commits/.*",
     # Ignore Hugging Face settings links which require login
     r"https://huggingface\.co/settings/tokens",
+    # Ignore GitHub PRs and blobs that trigger rate limiting
+    r"https://github\.com/AI-Hypercomputer/maxtext/pull/.*",
+    r"https://github\.com/google/maxtext/blob/.*",
 ]
 
 

docs/development/contribute_docs.md

@@ -24,7 +24,7 @@ in [MyST Markdown syntax](https://myst-parser.readthedocs.io/en/latest/syntax/ty
 
 If you are writing documentation for MaxText, you may want to preview the
 documentation site locally to ensure things work as expected before a deployment
-to [Read The Docs](https://readthedocs.org/).
+to [Read The Docs](https://about.readthedocs.com/?ref=app.readthedocs.org).
 
 First, make sure you
 [install MaxText from source](https://maxtext.readthedocs.io/en/latest/install_maxtext.html#from-source)

docs/reference.md

@@ -53,7 +53,7 @@ Key concepts including checkpointing strategies, quantization, tiling, and Mixtu
 
 ## 📚 API Reference
 
-Find comprehensive API documentation for MaxText modules, classes, and functions in the [API Reference page](reference/api.rst).
+Find comprehensive API documentation for MaxText modules, classes, and functions in the [API Reference page](reference/api).
 
 ```{toctree}
 ---
@@ -64,5 +64,5 @@ reference/performance_metrics
 reference/models
 reference/architecture
 reference/core_concepts
-reference/api.rst
+reference/api
 ```