From ff8a5104ed6d5ccc0bbfa5ad84853042924201a8 Mon Sep 17 00:00:00 2001 From: "Zenobia \"Z\" Redeaux" <161058543+zredeaux07@users.noreply.github.com> Date: Tue, 18 Aug 2026 13:36:36 -0700 Subject: [PATCH 01/13] Update Sphinx HTML theme and options Changed HTML theme from 'sphinx_rtd_theme' to 'nvidia_sphinx_theme' and updated theme options. Signed-off-by: Zenobia "Z" Redeaux <161058543+zredeaux07@users.noreply.github.com> --- docs/conf.py | 31 +++++++++++++------------------ 1 file changed, 13 insertions(+), 18 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index d2bba9825a..70b472d6f7 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -77,26 +77,21 @@ # -- Options for HTML output ------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output -html_theme = "sphinx_rtd_theme" -html_static_path = ["_static"] -html_show_sphinx = False - -html_css_files = [ - "css/nvidia_font.css", - "css/nvidia_footer.css", - "css/output-style.css", - "css/diagram-colors.css", - "css/sphinx_tabs.css", - "css/svg-responsive.css", - "css/rtabs.css", -] - +html_theme = "nvidia_sphinx_theme" html_theme_options = { - "collapse_navigation": False, - "logo_only": False, - "version_selector": False, - "language_selector": False, + "switcher": { + "json_url": "../versions1.json", + "version_match": release, + }, + "icon_links": [ + { + "name": "GitHub", + "url": "https://github.com/NVIDIA/Megatron-LM/", + "icon": "fa-brands fa-github", + } + ] } +html_extra_path = ["project.json", "versions1.json"] napoleon_custom_sections = [ ("Parallelism parameters", "params_style"), From 7a76a30c8b3703bcb4fb2eb3b76c44756546f67a Mon Sep 17 00:00:00 2001 From: "Zenobia \"Z\" Redeaux" <161058543+zredeaux07@users.noreply.github.com> Date: Tue, 18 Aug 2026 13:52:03 -0700 Subject: [PATCH 02/13] Add initial release notes placeholder Signed-off-by: Zenobia "Z" Redeaux <161058543+zredeaux07@users.noreply.github.com> --- docs/release_notes | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/release_notes diff --git a/docs/release_notes b/docs/release_notes new file mode 100644 index 0000000000..2bbf4d2ac2 --- /dev/null +++ b/docs/release_notes @@ -0,0 +1 @@ +Paste in the latest release notes. From fffd19efcb9a7aceeece0c67fd7b2174e5f7cb6a Mon Sep 17 00:00:00 2001 From: "Zenobia \"Z\" Redeaux" <161058543+zredeaux07@users.noreply.github.com> Date: Tue, 18 Aug 2026 13:53:38 -0700 Subject: [PATCH 03/13] Add release notes to documentation index Signed-off-by: Zenobia "Z" Redeaux <161058543+zredeaux07@users.noreply.github.com> --- docs/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/index.rst b/docs/index.rst index fcd15a7a11..a808ac25da 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -31,6 +31,7 @@ Transformer Engine documentation installation getting_started/index faq + release_notes .. toctree:: :hidden: From 474a2c0da1a078e2decf66c79621f8bfae67bdca Mon Sep 17 00:00:00 2001 From: "Zenobia \"Z\" Redeaux" <161058543+zredeaux07@users.noreply.github.com> Date: Tue, 18 Aug 2026 14:09:13 -0700 Subject: [PATCH 04/13] Apply suggestion from @greptile-apps[bot] Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com> Signed-off-by: Zenobia "Z" Redeaux <161058543+zredeaux07@users.noreply.github.com> --- docs/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/conf.py b/docs/conf.py index 70b472d6f7..380b1ba3be 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -86,7 +86,7 @@ "icon_links": [ { "name": "GitHub", - "url": "https://github.com/NVIDIA/Megatron-LM/", + "url": "https://github.com/NVIDIA/TransformerEngine/", "icon": "fa-brands fa-github", } ] From 57562cf45d5d6ef7afcd918b835bf622c182be83 Mon Sep 17 00:00:00 2001 From: "Zenobia \"Z\" Redeaux" <161058543+zredeaux07@users.noreply.github.com> Date: Tue, 18 Aug 2026 14:12:40 -0700 Subject: [PATCH 05/13] Rename release_notes to release_notes.rst Giving the file an extension. Signed-off-by: Zenobia "Z" Redeaux <161058543+zredeaux07@users.noreply.github.com> --- docs/{release_notes => release_notes.rst} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/{release_notes => release_notes.rst} (100%) diff --git a/docs/release_notes b/docs/release_notes.rst similarity index 100% rename from docs/release_notes rename to docs/release_notes.rst From 6c43d04043b52b0a4edbcd1ec1ef99392101db12 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Tue, 18 Aug 2026 21:18:49 +0000 Subject: [PATCH 06/13] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- docs/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/conf.py b/docs/conf.py index 380b1ba3be..3301024ba9 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -89,7 +89,7 @@ "url": "https://github.com/NVIDIA/TransformerEngine/", "icon": "fa-brands fa-github", } - ] + ], } html_extra_path = ["project.json", "versions1.json"] From 84d0546b061edaf565546791b7c66ff6ba785558 Mon Sep 17 00:00:00 2001 From: "Zenobia \"Z\" Redeaux" <161058543+zredeaux07@users.noreply.github.com> Date: Wed, 19 Aug 2026 10:38:29 -0700 Subject: [PATCH 07/13] Apply suggestion from @mckimn Co-authored-by: mckimn Signed-off-by: Zenobia "Z" Redeaux <161058543+zredeaux07@users.noreply.github.com> --- docs/conf.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/conf.py b/docs/conf.py index 3301024ba9..c5f103f60f 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -59,6 +59,8 @@ "breathe", "autoapi.extension", "sphinx_tabs.tabs", + "myst_parser", + "nvidia-sphinx-theme", ] templates_path = ["_templates"] From f45f74e15243ae99ccccc520fcaddfeca38125dd Mon Sep 17 00:00:00 2001 From: "Zenobia \"Z\" Redeaux" <161058543+zredeaux07@users.noreply.github.com> Date: Wed, 19 Aug 2026 10:39:29 -0700 Subject: [PATCH 08/13] Apply suggestion from @mckimn Co-authored-by: mckimn Signed-off-by: Zenobia "Z" Redeaux <161058543+zredeaux07@users.noreply.github.com> --- docs/conf.py | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/conf.py b/docs/conf.py index c5f103f60f..62a77ab9ee 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -81,6 +81,7 @@ html_theme = "nvidia_sphinx_theme" html_theme_options = { + "public_docs_features": True, "switcher": { "json_url": "../versions1.json", "version_match": release, From 8a1b63a42f900e1dd37fe1e5cf0ebb5df3a6a033 Mon Sep 17 00:00:00 2001 From: "Zenobia \"Z\" Redeaux" <161058543+zredeaux07@users.noreply.github.com> Date: Tue, 25 Aug 2026 10:17:50 -0700 Subject: [PATCH 09/13] Minor updates --- docs/release_notes.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 docs/release_notes.md diff --git a/docs/release_notes.md b/docs/release_notes.md new file mode 100644 index 0000000000..bef7944707 --- /dev/null +++ b/docs/release_notes.md @@ -0,0 +1,17 @@ +# Transformer Engine v2.19 Release Notes + +## Key Features and Enhancements + +- + +## Fixed Issues + +- + +## Breaking Changes in This Release + +There are no breaking changes in this release. + +## Deprecated Features + +There are no deprecated features in this release. From f107a936647245dfa62561cdb368dc1f4f7fbb86 Mon Sep 17 00:00:00 2001 From: "Zenobia \"Z\" Redeaux" <161058543+zredeaux07@users.noreply.github.com> Date: Tue, 25 Aug 2026 10:19:07 -0700 Subject: [PATCH 10/13] Added PR feedback --- docs/index.rst | 2 +- docs/release_notes.rst | 1 - 2 files changed, 1 insertion(+), 2 deletions(-) delete mode 100644 docs/release_notes.rst diff --git a/docs/index.rst b/docs/index.rst index a808ac25da..0ef0d16dfe 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -31,7 +31,7 @@ Transformer Engine documentation installation getting_started/index faq - release_notes + release_notes.md .. toctree:: :hidden: diff --git a/docs/release_notes.rst b/docs/release_notes.rst deleted file mode 100644 index 2bbf4d2ac2..0000000000 --- a/docs/release_notes.rst +++ /dev/null @@ -1 +0,0 @@ -Paste in the latest release notes. From 56816bcf6a80c71f8722a70ee02af7f1da550982 Mon Sep 17 00:00:00 2001 From: "Zenobia \"Z\" Redeaux" <161058543+zredeaux07@users.noreply.github.com> Date: Tue, 25 Aug 2026 12:06:27 -0700 Subject: [PATCH 11/13] Additional PR updates --- docs/conf.py | 4 ++-- docs/versions1.json | 14 ++++++++++++++ 2 files changed, 16 insertions(+), 2 deletions(-) create mode 100644 docs/versions1.json diff --git a/docs/conf.py b/docs/conf.py index 62a77ab9ee..27c44cb000 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -83,7 +83,7 @@ html_theme_options = { "public_docs_features": True, "switcher": { - "json_url": "../versions1.json", + "json_url": "./versions1.json", "version_match": release, }, "icon_links": [ @@ -94,7 +94,7 @@ } ], } -html_extra_path = ["project.json", "versions1.json"] +html_extra_path = ["versions1.json"] napoleon_custom_sections = [ ("Parallelism parameters", "params_style"), diff --git a/docs/versions1.json b/docs/versions1.json new file mode 100644 index 0000000000..e1f48f8ddd --- /dev/null +++ b/docs/versions1.json @@ -0,0 +1,14 @@ +[ + + { + "name": "Current release", + "version": "latest", + "url": "https://docs.nvidia.com/deeplearning/transformer-engine/", + "preferred": true + }, + { + "name": "Older releases", + "version": "archives", + "url": "https://docs.nvidia.com/deeplearning/transformer-engine/documentation-archive.html" + } +] From b3f3b7d5684f05e404da4ebeb979edb17b460382 Mon Sep 17 00:00:00 2001 From: Nathan McKimpson Date: Tue, 25 Aug 2026 14:51:00 -0700 Subject: [PATCH 12/13] Updates for NVIDIA theme and version selection --- .github/workflows/docs.yml | 2 +- docs/.gitignore | 1 - docs/Makefile | 9 +- docs/_static/NVIDIA-LogoBlack.svg | 1 - docs/_static/css/nvidia_font.css | 53 ------ docs/_static/css/nvidia_footer.css | 29 ---- docs/_static/css/rtabs.css | 43 ----- docs/_static/css/sphinx_tabs.css | 11 -- docs/_static/css/svg-responsive.css | 3 +- ...vidia-logo-horiz-rgb-1c-blk-for-screen.svg | 1 + ...vidia-logo-horiz-rgb-1c-wht-for-screen.svg | 1 + .../nvidia-logo-horiz-rgb-blk-for-screen.svg | 1 + .../nvidia-logo-horiz-rgb-wht-for-screen.svg | 1 + docs/_templates/footer.html | 23 --- docs/_templates/layout.html | 103 ------------ docs/conf.py | 31 +++- docs/documentation-archive.rst | 154 ++++++++++++++++++ docs/index.rst | 2 +- docs/release_notes.md | 6 +- docs/version_select.patch | 21 --- docs/versions1.json | 3 +- 21 files changed, 191 insertions(+), 308 deletions(-) delete mode 100644 docs/_static/NVIDIA-LogoBlack.svg delete mode 100644 docs/_static/css/nvidia_font.css delete mode 100644 docs/_static/css/nvidia_footer.css delete mode 100644 docs/_static/css/rtabs.css create mode 100644 docs/_static/nvidia-logo-horiz-rgb-1c-blk-for-screen.svg create mode 100644 docs/_static/nvidia-logo-horiz-rgb-1c-wht-for-screen.svg create mode 100644 docs/_static/nvidia-logo-horiz-rgb-blk-for-screen.svg create mode 100644 docs/_static/nvidia-logo-horiz-rgb-wht-for-screen.svg delete mode 100644 docs/_templates/footer.html delete mode 100644 docs/_templates/layout.html create mode 100644 docs/documentation-archive.rst delete mode 100644 docs/version_select.patch diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 9d38d709e4..80ecce3c97 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -21,7 +21,7 @@ jobs: uses: actions/checkout@v3 - name: 'Install dependencies' run: | - pip install sphinx==8.1.3 sphinx_rtd_theme==3.0.1 nbsphinx==0.9.5 IPython ipython_genutils==0.2.0 ipywidgets==8.0.2 astroid==3.3.2 sphinx-tabs==3.4.7 + pip install sphinx==8.1.3 nvidia-sphinx-theme==0.0.9.post1 pydata-sphinx-theme==0.19.0 nbsphinx==0.9.5 IPython ipython_genutils==0.2.0 ipywidgets==8.0.2 astroid==3.3.2 sphinx-tabs==3.4.7 myst-parser==4.0.1 pip install breathe==4.35.0 sphinx-autoapi==3.3.2 sudo apt-get install -y pandoc graphviz doxygen export GIT_SHA=$(git show-ref --hash HEAD) diff --git a/docs/.gitignore b/docs/.gitignore index 409af2d74e..b26c4f6ccc 100644 --- a/docs/.gitignore +++ b/docs/.gitignore @@ -1,3 +1,2 @@ _build doxygen -sphinx_rtd_theme \ No newline at end of file diff --git a/docs/Makefile b/docs/Makefile index 800eeea78a..c7271eadef 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -16,10 +16,5 @@ help: # Catch-all target: route all unknown targets to Sphinx using the new # "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). -%: Makefile sphinx_rtd_theme - PYTHONPATH=sphinx_rtd_theme:$(PYTHONPATH) $(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) - -# Patch Sphinx RTD theme 3.0.1 to add version selector in sidebar -sphinx_rtd_theme: - git clone --depth=1 -b 3.0.1 --single-branch https://github.com/readthedocs/sphinx_rtd_theme.git - bash -c "cd sphinx_rtd_theme; git apply ../version_select.patch" +%: Makefile + $(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) diff --git a/docs/_static/NVIDIA-LogoBlack.svg b/docs/_static/NVIDIA-LogoBlack.svg deleted file mode 100644 index c612396c71..0000000000 --- a/docs/_static/NVIDIA-LogoBlack.svg +++ /dev/null @@ -1 +0,0 @@ -NVIDIA-LogoBlack \ No newline at end of file diff --git a/docs/_static/css/nvidia_font.css b/docs/_static/css/nvidia_font.css deleted file mode 100644 index 0c544779bb..0000000000 --- a/docs/_static/css/nvidia_font.css +++ /dev/null @@ -1,53 +0,0 @@ -@font-face { - font-family: NVIDIA; - font-style: normal; - font-weight: 300; - src: url(https://images.nvidia.com/etc/designs/nvidiaGDC/clientlibs_base/fonts/nvidia-sans/GLOBAL/NVIDIASans_W_Lt.woff) format("woff"),url(https://images.nvidia.com/etc/designs/nvidiaGDC/clientlibs_base/fonts/nvidia-sans/GLOBAL/NVIDIASans_W_Lt.woff2) format("woff2") -} - -@font-face { - font-family: NVIDIA; - font-style: normal; - font-weight: 400; - src: url(https://images.nvidia.com/etc/designs/nvidiaGDC/clientlibs_base/fonts/nvidia-sans/GLOBAL/NVIDIASans_W_Rg.woff) format("woff"),url(https://images.nvidia.com/etc/designs/nvidiaGDC/clientlibs_base/fonts/nvidia-sans/GLOBAL/NVIDIASans_W_Rg.woff2) format("woff2") -} - -@font-face { - font-family: NVIDIA; - font-style: normal; - font-weight: 500; - src: url(https://images.nvidia.com/etc/designs/nvidiaGDC/clientlibs_base/fonts/nvidia-sans/GLOBAL/NVIDIASans_W_Md.woff) format("woff"),url(https://images.nvidia.com/etc/designs/nvidiaGDC/clientlibs_base/fonts/nvidia-sans/GLOBAL/NVIDIASans_W_Md.woff2) format("woff2") -} - -@font-face { - font-family: NVIDIA; - font-style: normal; - font-weight: 700; - src: url(https://images.nvidia.com/etc/designs/nvidiaGDC/clientlibs_base/fonts/nvidia-sans/GLOBAL/NVIDIASans_W_Bd.woff) format("woff"),url(https://images.nvidia.com/etc/designs/nvidiaGDC/clientlibs_base/fonts/nvidia-sans/GLOBAL/NVIDIASans_W_Bd.woff2) format("woff2") -} - -body { - font-family: NVIDIA,Lato,proxima-nova,Helvetica Neue,Arial,sans-serif; -} - -.rst-content .toctree-wrapper>p.caption,h1,h2,h3,h4,h5,h6,legend { - margin-top: 0; - font-weight: 700; - font-family: NVIDIA,Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif -} - -input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week] { - font-family: NVIDIA,Lato,proxima-nova,Helvetica Neue,Arial,sans-serif; -} - -select { - font-family: NVIDIA,Lato,proxima-nova,Helvetica Neue,Arial,sans-serif; -} - -.btn { - font-family: NVIDIA,Lato,proxima-nova,Helvetica Neue,Arial,sans-serif; -} - -html.writer-html4 .rst-content dl:not(.docutils) .descclassname,html.writer-html4 .rst-content dl:not(.docutils) .descname,html.writer-html4 .rst-content dl:not(.docutils) .sig-name,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .sig-name { - font-family: NVIDIA,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace; -} diff --git a/docs/_static/css/nvidia_footer.css b/docs/_static/css/nvidia_footer.css deleted file mode 100644 index 9d18fb3b47..0000000000 --- a/docs/_static/css/nvidia_footer.css +++ /dev/null @@ -1,29 +0,0 @@ -footer img { - display: block; - width: 137.5px; - position: relative; - left: -9px; - margin: 0 0 15px 0; -} - -footer p { - color: #666666; - font-weight: normal; - font-size: 12px; - line-height: 1.25em; -} - -footer p:not(.notices) { - display: inline; - margin: 0; -} - -footer p a, -footer p a:link, -footer p a:visited { - color: #666666; -} - -footer p a:hover { - color: #666666; -} diff --git a/docs/_static/css/rtabs.css b/docs/_static/css/rtabs.css deleted file mode 100644 index 7f4213ef99..0000000000 --- a/docs/_static/css/rtabs.css +++ /dev/null @@ -1,43 +0,0 @@ -/* Custom styling for sphinx-tabs */ - -.sphinx-tabs { - margin-bottom: 1rem; -} - -.sphinx-tabs-tab { - background-color: #f4f4f4; - border: 1px solid #ccc; - border-bottom: none; - padding: 0.5rem 1rem; - margin-right: 0.5rem; - cursor: pointer; - font-weight: 500; - transition: background-color 0.2s; -} - -.sphinx-tabs-tab:hover { - background-color: #e0e0e0; -} - -.sphinx-tabs-tab[aria-selected="true"] { - background-color: #76b900; /* NVIDIA green */ - color: white; - border-color: #76b900; - margin-right: 0.5rem; -} - -.sphinx-tabs-panel { - border: 1px solid #ccc; - padding: 1rem; - background-color: #f9f9f9; -} - -/* Dark mode support for RTD theme */ -.rst-content .sphinx-tabs-tab { - color: #333; -} - -.rst-content .sphinx-tabs-tab[aria-selected="true"] { - color: white; -} - diff --git a/docs/_static/css/sphinx_tabs.css b/docs/_static/css/sphinx_tabs.css index c3e524e0e9..ecb2e2e00f 100644 --- a/docs/_static/css/sphinx_tabs.css +++ b/docs/_static/css/sphinx_tabs.css @@ -32,14 +32,3 @@ background-color: #f9f9f9; } -/* Dark mode support for RTD theme */ -.rst-content .sphinx-tabs-tab { - color: #333; -} - -.rst-content .sphinx-tabs-tab[aria-selected="true"] { - color: white; -} - - - diff --git a/docs/_static/css/svg-responsive.css b/docs/_static/css/svg-responsive.css index 3ffe14eb14..fe66b0524d 100644 --- a/docs/_static/css/svg-responsive.css +++ b/docs/_static/css/svg-responsive.css @@ -3,7 +3,7 @@ /* Make all SVG images responsive */ .document svg, .document object[type="image/svg+xml"], -.rst-content svg { +.bd-content svg { max-width: 100%; height: auto; display: block; @@ -69,4 +69,3 @@ - diff --git a/docs/_static/nvidia-logo-horiz-rgb-1c-blk-for-screen.svg b/docs/_static/nvidia-logo-horiz-rgb-1c-blk-for-screen.svg new file mode 100644 index 0000000000..900395542a --- /dev/null +++ b/docs/_static/nvidia-logo-horiz-rgb-1c-blk-for-screen.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/_static/nvidia-logo-horiz-rgb-1c-wht-for-screen.svg b/docs/_static/nvidia-logo-horiz-rgb-1c-wht-for-screen.svg new file mode 100644 index 0000000000..45f6c6437f --- /dev/null +++ b/docs/_static/nvidia-logo-horiz-rgb-1c-wht-for-screen.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/_static/nvidia-logo-horiz-rgb-blk-for-screen.svg b/docs/_static/nvidia-logo-horiz-rgb-blk-for-screen.svg new file mode 100644 index 0000000000..08844b77b9 --- /dev/null +++ b/docs/_static/nvidia-logo-horiz-rgb-blk-for-screen.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/_static/nvidia-logo-horiz-rgb-wht-for-screen.svg b/docs/_static/nvidia-logo-horiz-rgb-wht-for-screen.svg new file mode 100644 index 0000000000..6798f1596a --- /dev/null +++ b/docs/_static/nvidia-logo-horiz-rgb-wht-for-screen.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/_templates/footer.html b/docs/_templates/footer.html deleted file mode 100644 index 1ef5505d34..0000000000 --- a/docs/_templates/footer.html +++ /dev/null @@ -1,23 +0,0 @@ -{% extends '!footer.html' %} - -{% block contentinfo %} - -

-Privacy Policy -| -Manage My Privacy -| -Do Not Sell or Share My Data -| -Terms of Service -| -Accessibility -| -Corporate Policies -| -Product Security -| -Contact -

-{{ super() }} -{% endblock %} diff --git a/docs/_templates/layout.html b/docs/_templates/layout.html deleted file mode 100644 index 99ae0702a8..0000000000 --- a/docs/_templates/layout.html +++ /dev/null @@ -1,103 +0,0 @@ -{% extends "!layout.html" %} - - {% block extrahead %} - - - - {% endblock %} - - {% block sidebartitle %} {{ super() }} - - - - - {% endblock %} - - {% block footer %} - - - - {% endblock %} diff --git a/docs/conf.py b/docs/conf.py index 27c44cb000..6f3a891cae 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -9,7 +9,7 @@ from builtins import str # Basic project info -project = "Transformer Engine" +project_name = "Transformer Engine" author = "NVIDIA CORPORATION & AFFILIATES" # Copyright statement @@ -46,6 +46,7 @@ else: version = str(_raw_version) release = _raw_version +project = f"{project_name} {release}" # -- General configuration --------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration @@ -60,17 +61,17 @@ "autoapi.extension", "sphinx_tabs.tabs", "myst_parser", - "nvidia-sphinx-theme", ] -templates_path = ["_templates"] exclude_patterns = [ "_build", "Thumbs.db", - "sphinx_rtd_theme", ] -source_suffix = ".rst" +source_suffix = { + ".rst": "restructuredtext", + ".md": "markdown", +} master_doc = "index" @@ -80,12 +81,28 @@ # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output html_theme = "nvidia_sphinx_theme" +html_static_path = ["_static"] +html_css_files = [ + "css/output-style.css", + "css/diagram-colors.css", + "css/sphinx_tabs.css", + "css/svg-responsive.css", +] + +# Allow local previews to test the version switcher before the production JSON is published. +switcher_json_url = os.getenv( + "NVTE_DOCS_SWITCHER_JSON_URL", + "https://docs.nvidia.com/deeplearning/transformer-engine/versions1.json", +) +switcher_version = os.getenv("NVTE_DOCS_SWITCHER_VERSION", "latest") + html_theme_options = { "public_docs_features": True, "switcher": { - "json_url": "./versions1.json", - "version_match": release, + "json_url": switcher_json_url, + "version_match": switcher_version, }, + "check_switcher": False, "icon_links": [ { "name": "GitHub", diff --git a/docs/documentation-archive.rst b/docs/documentation-archive.rst new file mode 100644 index 0000000000..2bb001c3aa --- /dev/null +++ b/docs/documentation-archive.rst @@ -0,0 +1,154 @@ +:orphan: + +Documentation Archive +===================== + +Documentation for all releases of NVIDIA Transformer Engine are referenced below. The current release is first. + +.. list-table:: + :header-rows: 1 + :widths: 30 70 + + * - Release + - Documentation + * - 2.18 + - | `User Guide <../transformer-engine-releases/release-2.18/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.18/release-notes/index.html>`__ + * - 2.17 + - | `User Guide <../transformer-engine-releases/release-2.17/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.17/release-notes/index.html>`__ + * - 2.16 + - | `User Guide <../transformer-engine-releases/release-2.16/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.16/release-notes/index.html>`__ + * - 2.15 + - | `User Guide <../transformer-engine-releases/release-2.15/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.15/release-notes/index.html>`__ + * - 2.14 + - | `User Guide <../transformer-engine-releases/release-2.14/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.14/release-notes/index.html>`__ + * - 2.13 + - | `User Guide <../transformer-engine-releases/release-2.13/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.13/release-notes/index.html>`__ + * - 2.12 + - | `User Guide <../transformer-engine-releases/release-2.12/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.12/release-notes/index.html>`__ + * - 2.11 + - | `User Guide <../transformer-engine-releases/release-2.11/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.11/release-notes/index.html>`__ + * - 2.10 + - | `User Guide <../transformer-engine-releases/release-2.10/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.10/release-notes/index.html>`__ + * - 2.9 + - | `User Guide <../transformer-engine-releases/release-2.9/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.9/release-notes/index.html>`__ + * - 2.8 + - | `User Guide <../transformer-engine-releases/release-2.8/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.8/release-notes/index.html>`__ + * - 2.7 + - | `User Guide <../transformer-engine-releases/release-2.7/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.7/release-notes/index.html>`__ + * - 2.6 + - | `User Guide <../transformer-engine-releases/release-2.6/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.6/release-notes/index.html>`__ + * - 2.5 + - | `User Guide <../transformer-engine-releases/release-2.5/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.5/release-notes/index.html>`__ + * - 2.4 + - | `User Guide <../transformer-engine-releases/release-2.4/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.4/release-notes/index.html>`__ + * - 2.3 + - | `User Guide <../transformer-engine-releases/release-2.3/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.3/release-notes/index.html>`__ + * - 2.2 + - | `User Guide <../transformer-engine-releases/release-2.2/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.2/release-notes/index.html>`__ + * - 2.1 + - | `User Guide <../transformer-engine-releases/release-2.1/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.1/release-notes/index.html>`__ + * - 2.0 + - | `User Guide <../transformer-engine-releases/release-2.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-2.0/release-notes/index.html>`__ + * - 1.13 + - | `User Guide <../transformer-engine-releases/release-1.13/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-1.13/release-notes/index.html>`__ + * - 1.12 + - | `User Guide <../transformer-engine-releases/release-1.12/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-1.12/release-notes/index.html>`__ + * - 1.11 + - | `User Guide <../transformer-engine-releases/release-1.11/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-1.11/release-notes/index.html>`__ + * - 1.10 + - | `User Guide <../transformer-engine-releases/release-1.10/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-1.10/release-notes/index.html>`__ + * - 1.9 + - | `User Guide <../transformer-engine-releases/release-1.9/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-1.9/release-notes/index.html>`__ + * - 1.8 + - | `User Guide <../transformer-engine-releases/release-1.8/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-1.8/release-notes/index.html>`__ + * - 1.7 + - | `User Guide <../transformer-engine-releases/release-1.7/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-1.7/release-notes/index.html>`__ + * - 1.6 + - | `User Guide <../transformer-engine-releases/release-1.6/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-1.6/release-notes/index.html>`__ + * - 1.5 + - | `User Guide <../transformer-engine-releases/release-1.5/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-1.5/release-notes/index.html>`__ + * - 1.4 + - | `User Guide <../transformer-engine-releases/release-1.4/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-1.4/release-notes/index.html>`__ + * - 1.3 + - | `User Guide <../transformer-engine-releases/release-1.3/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-1.3/release-notes/index.html>`__ + * - 1.2.1 + - | `User Guide <../transformer-engine-releases/release-1.2.1/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-1.2.1/release-notes/index.html>`__ + * - 1.2.0 + - | `User Guide <../transformer-engine-releases/release-1.2.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-1.2.0/release-notes/index.html>`__ + * - 1.1.0 + - | `User Guide <../transformer-engine-releases/release-1.1.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-1.1.0/release-notes/index.html>`__ + * - 1.0.0 + - | `User Guide <../transformer-engine-releases/release-1.0.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-1.0.0/release-notes/index.html>`__ + * - 0.13.0 + - | `User Guide <../transformer-engine-releases/release-0.13.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-0.13.0/release-notes/index.html>`__ + * - 0.12.0 + - | `User Guide <../transformer-engine-releases/release-0.12.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-0.12.0/release-notes/index.html>`__ + * - 0.11.0 + - | `User Guide <../transformer-engine-releases/release-0.11.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-0.11.0/release-notes/index.html>`__ + * - 0.10.0 + - | `User Guide <../transformer-engine-releases/release-0.10.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-0.10.0/release-notes/index.html>`__ + * - 0.9.0 + - | `User Guide <../transformer-engine-releases/release-0.9.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-0.9.0/release-notes/index.html>`__ + * - 0.8.0 + - | `User Guide <../transformer-engine-releases/release-0.8.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-0.8.0/release-notes/index.html>`__ + * - 0.7.0 + - | `User Guide <../transformer-engine-releases/release-0.7.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-0.7.0/release-notes/index.html>`__ + * - 0.6.0 + - | `User Guide <../transformer-engine-releases/release-0.6.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-0.6.0/release-notes/index.html>`__ + * - 0.5.0 + - | `User Guide <../transformer-engine-releases/release-0.5.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-0.5.0/release-notes/index.html>`__ + * - 0.4.0 + - | `User Guide <../transformer-engine-releases/release-0.4.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-0.4.0/release-notes/index.html>`__ + * - 0.3.0 + - | `User Guide <../transformer-engine-releases/release-0.3.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-0.3.0/release-notes/index.html>`__ + * - 0.2.0 + - | `User Guide <../transformer-engine-releases/release-0.2.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-0.2.0/release-notes/index.html>`__ + * - 0.1.0 + - | `User Guide <../transformer-engine-releases/release-0.1.0/user-guide/index.html>`__ + | `Release Notes <../transformer-engine-releases/release-0.1.0/release-notes/index.html>`__ diff --git a/docs/index.rst b/docs/index.rst index 0ef0d16dfe..5dad5fdd83 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -4,7 +4,7 @@ See LICENSE for license information. Transformer Engine documentation -================================= +================================================= .. ifconfig:: "dev" in release diff --git a/docs/release_notes.md b/docs/release_notes.md index bef7944707..f2b0450cef 100644 --- a/docs/release_notes.md +++ b/docs/release_notes.md @@ -1,12 +1,12 @@ -# Transformer Engine v2.19 Release Notes +# Transformer Engine vX.Y Release Notes ## Key Features and Enhancements -- +- ## Fixed Issues -- +- ## Breaking Changes in This Release diff --git a/docs/version_select.patch b/docs/version_select.patch deleted file mode 100644 index 75f29fff81..0000000000 --- a/docs/version_select.patch +++ /dev/null @@ -1,21 +0,0 @@ -diff --git a/sphinx_rtd_theme/layout.html b/sphinx_rtd_theme/layout.html -index e6a38b1..579eaec 100644 ---- a/sphinx_rtd_theme/layout.html -+++ b/sphinx_rtd_theme/layout.html -@@ -124,6 +124,16 @@ - {%- endif %} - - -+ {# Show TE version and version selector #} -+
-+ {{ version }} -+
-+ Version select: -+
-+ - {%- if READTHEDOCS or DEBUG %} - {%- if theme_version_selector or theme_language_selector %} -
diff --git a/docs/versions1.json b/docs/versions1.json index e1f48f8ddd..1c45c632f4 100644 --- a/docs/versions1.json +++ b/docs/versions1.json @@ -1,7 +1,6 @@ [ - { - "name": "Current release", + "name": "Latest", "version": "latest", "url": "https://docs.nvidia.com/deeplearning/transformer-engine/", "preferred": true From b4965e80801b7c3edecf5d96a9028839528faed9 Mon Sep 17 00:00:00 2001 From: Nathan McKimpson Date: Tue, 25 Aug 2026 15:14:40 -0700 Subject: [PATCH 13/13] Add copyright to documentation-archive.rst --- docs/documentation-archive.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/documentation-archive.rst b/docs/documentation-archive.rst index 2bb001c3aa..e74875aba2 100644 --- a/docs/documentation-archive.rst +++ b/docs/documentation-archive.rst @@ -1,3 +1,8 @@ +.. + Copyright (c) 2022-2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. + + See LICENSE for license information. + :orphan: Documentation Archive