Skip to content

Misc docs rendering fixes - #3450

Draft
ksivaman wants to merge 3 commits into
NVIDIA:mainfrom
ksivaman:misc_rendering_fixes
Draft

Misc docs rendering fixes#3450
ksivaman wants to merge 3 commits into
NVIDIA:mainfrom
ksivaman:misc_rendering_fixes

Conversation

@ksivaman

Copy link
Copy Markdown
Member

Description

Please include a brief summary of the changes, relevant motivation and context.

Fixes # (issue)

Type of change

  • Documentation change (change only to the documentation, either a fix or a new content)
  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Infra/Build change
  • Code refactoring

Changes

Please list the changes introduced in this PR:

  • Change A
  • Change B

Checklist:

  • I have read and followed the contributing guidelines
  • The functionality is complete
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes

Signed-off-by: Kirthi Shankar Sivamani <ksivamani@nvidia.com>
Signed-off-by: Kirthi Shankar Sivamani <ksivamani@nvidia.com>
# Conflicts:
#	.github/workflows/docs.yml
@ksivaman
ksivaman marked this pull request as draft August 31, 2026 22:40
@greptile-apps

greptile-apps Bot commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

The PR fixes documentation rendering by using a local version-switcher manifest in CI, adding dark-theme colors for diagrams and output blocks, and making inline SVG content responsive within the current Sphinx theme.

  • Configures documentation CI to use the bundled versions1.json.
  • Adds dark-mode styling for diagrams and rendered program output.
  • Updates responsive SVG selectors for the bd-article content container.

Confidence Score: 5/5

The PR appears safe to merge, with no concrete blocking or independently actionable issues identified.

The local switcher manifest is included in the documentation artifact, and the CSS changes target the inline diagrams and dark-theme output elements they are intended to correct.

Important Files Changed

Filename Overview
.github/workflows/docs.yml Uses the bundled switcher manifest during the warnings-as-errors documentation build; the manifest is included in the generated artifact.
docs/_static/css/diagram-colors.css Adds dark-theme fills, strokes, and text colors for project-authored inline diagrams.
docs/_static/css/output-style.css Adds dark-theme backgrounds, borders, text colors, and shadows for output blocks.
docs/_static/css/svg-responsive.css Extends responsive sizing and horizontal overflow handling to SVGs embedded directly beneath the current theme’s article container.

Reviews (1): Last reviewed commit: "Merge branch 'main' into fix_preview_doc..." | Re-trigger Greptile

@ptrendx ptrendx added the 2.19 label Aug 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants