Adopt instinct-design flavor: Instinct Design System landing-page redesign - #133
Draft
AMD-melliott wants to merge 1 commit into
Draft
Adopt instinct-design flavor: Instinct Design System landing-page redesign#133AMD-melliott wants to merge 1 commit into
AMD-melliott wants to merge 1 commit into
Conversation
AMD-melliott
force-pushed
the
mat49-redesign
branch
from
August 28, 2026 19:22
4c8465d to
ed2d189
Compare
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. - Add "Slurm" to the spellcheck wordlist. - Add ROCm open-source compliance files: a dual MIT/CC BY 4.0 LICENSE.txt (adapted from rocm-docs-core, with the CC BY 4.0 carve-out scoped to docs/images, docs/system-admin/images, and docs/isv-apps/images), a minimal SECURITY.md pointing to GitHub private vulnerability reporting and AMD PSIRT, and a docs-focused CONTRIBUTING.md covering the Sphinx build and lint/spellcheck checks. - Point Industries/Verticals to the now-live gsid-verticals-docs project (https://instinct.docs.amd.com/projects/gsid-verticals-docs/en/latest/), completing a migration the redesign had already stubbed out with a placeholder GitHub link: - Swap the placeholder nav link (toc + index.md rail) for the real URL. - Remove the local vision/, data-science/, life-science/, finance/, isv-apps/, and simulation/ page trees now that the content lives in gsid-verticals-docs. - Add redirects for every old docname so existing bookmarks/inbound links land on the new project instead of 404ing. MONAI, DevitoPRO, and GSplat were dropped or never migrated, so those three fall back to the nearest index page rather than a dead link. - Fix a stale LICENSE.txt reference to the now-removed docs/isv-apps/images path.
AMD-melliott
force-pushed
the
mat49-redesign
branch
from
August 28, 2026 19:28
ed2d189 to
7c09d98
Compare
This was referenced Aug 31, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation
Cut over instinct-docs to the official
instinct-designflavor shipped byrocm-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 oldersphinx-designgrid-item-card/photography-based cards with something more consistent and easier to maintain.Technical Details
flavor: "instinct-design"(superseding the manually-vendored design-system assets from the original port).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.docs/_static/css/index.cssstatic-asset reference inconf.py'ssetup()(the realindex.csswas already loading correctly viahtml_css_files; theadd_css_filecall pointed at a path that never existed).docs/resources/{index,common-reference}.mdpages 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.rocm_docs_generate_llmsand the newrepository_url/use_repository_button/use_issues_button/use_download_buttontheme options already ondevelop.developsince 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
docs/resources/*pages.Submission Checklist