Skip to content

Adopt instinct-design flavor: Instinct Design System landing-page redesign - #133

Draft
AMD-melliott wants to merge 2 commits into
ROCm:developfrom
AMD-melliott:mat49-redesign
Draft

Adopt instinct-design flavor: Instinct Design System landing-page redesign#133
AMD-melliott wants to merge 2 commits into
ROCm:developfrom
AMD-melliott:mat49-redesign

Conversation

@AMD-melliott

Copy link
Copy Markdown
Collaborator

Motivation

Cut over instinct-docs to the official instinct-design flavor shipped by rocm-docs-core, and redesign the landing page and System Administrators subpages around a shared, reusable icon-card component. This replaces the earlier manual asset port and the older sphinx-design grid-item-card/photography-based cards with something more consistent and easier to maintain.

Technical Details

  • Adopt flavor: "instinct-design" (superseding the manually-vendored design-system assets from the original port).
  • Introduce system-admin/_cards/*.md — reusable MyST {include} partials, one per tool/resource card — used across the landing page and all System Administrators subpages (bare-metal, cluster, co-tools, cloud, virtualization) instead of duplicating card markup per page.
  • Add a collapsible primary sidebar with a working toggle, a sticky on-page rail, and default-open System Administrator groups.
  • Fix the dead docs/_static/css/index.css static-asset reference in conf.py's setup() (the real index.css was already loading correctly via html_css_files; the add_css_file call pointed at a path that never existed).
  • Consolidate the separately-added docs/resources/{index,common-reference}.md pages into the redesign's existing landing-page sections, since their content (Enterprise AI, Omnistat, CVS, AMD SMI, RVS, Instinct Micro-architecture, HIP C++, OpenMP, etc.) was fully duplicated there.
  • Pick up rocm_docs_generate_llms and the new repository_url/use_repository_button/use_issues_button/use_download_button theme options already on develop.
  • Ported forward content added to develop since this branch diverged — Spur, MI3XX Reference Design, AMD-DriveNets System Reference Architecture, and a RoCE traffic-analysis blog card — into the new icon-card format so nothing added upstream in the interim was lost.

Test Plan

  • Confirm the ReadTheDocs dev build for this PR succeeds with no Sphinx warnings/errors.
  • Spot-check the landing page, System Administrators subpages, dark/light toggle, and sidebar toggle behavior.
  • Confirm no dangling references to the removed docs/resources/* pages.

Submission Checklist

…e redesign

Squashed redesign work developed on amd-tme/instinct-docs, merged forward
onto current develop (includes the gpu-arch removal and Spur addition
already on develop).

- Cut over to the official instinct-design flavor from rocm-docs-core
  (superseding the earlier manual asset port).
- Redesign the landing page and System Administrators subpages
  (bare-metal, cluster, co-tools, cloud, virtualization) around a shared
  icon-card component (`system-admin/_cards/*.md` MyST includes), replacing
  the old sphinx-design grid-item-card/img-top photography.
- Add a collapsible primary sidebar with a working toggle, a sticky
  on-page rail, and default-open System Administrator groups.
- Fix the dead `css/index.css` static-asset reference in conf.py's setup().
- Consolidate the separately-added Resources pages (Tools /
  Common Reference) into the redesign's existing landing-page sections,
  since their content was fully duplicated there.
- Port forward new content added to develop in the interim (Spur, MI3XX
  Reference Design, AMD-DriveNets System Reference Architecture, a RoCE
  traffic-analysis blog card) into the new icon-card format.
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.

1 participant