Skip to content

Feature: Site layout re-alignment#120

Merged
AMD-melliott merged 5 commits into
ROCm:developfrom
mbenavidez-amd:feature/cluster-redesign
Jun 25, 2026
Merged

Feature: Site layout re-alignment#120
AMD-melliott merged 5 commits into
ROCm:developfrom
mbenavidez-amd:feature/cluster-redesign

Conversation

@mbenavidez-amd

Copy link
Copy Markdown
Collaborator

Motivation

This pull request restructures and improves the organization of documentation resources, particularly on the main landing page and navigation menus. It introduces dedicated resource and reference pages, updates the layout for better usability, and consolidates related links under clearer categories. The changes also clean up and modernize the presentation of tools and reference materials, making it easier for users to find relevant documentation and utilities.

Technical Details

Documentation Structure and Navigation:

  • Introduced new resource pages: docs/resources/index.md (for tools) and docs/resources/common-reference.md (for common references), and updated the table of contents in docs/sphinx/_toc.yml.in to group related links under "Resources" and "Common Reference" sections. This improves discoverability and organization of documentation links.
  • Removed redundant or outdated links from the main navigation and reorganized cluster and reference links for consistency and clarity.

Landing Page and Content Updates:

  • Refactored the main landing page (docs/index.md) to use tabbed and dropdown layouts for tools and references, providing a more user-friendly and visually organized interface.
  • Updated and re-categorized several resource cards, including moving "Enterprise AI" and "Omnistat" under a new "Tools" tab and updating images and descriptions for clarity.

Reference Material Organization:

  • Moved individual reference cards (e.g., GPU Partitioning, AMD SMI API Doc, HIP C++, OpenMP, etc.) into a consolidated "Common Reference" dropdown and updated their presentation for consistency.

Cleanup:

  • Removed the obsolete docs/core/index.md file, as its content is now covered by the new reference structure.

Minor Content and Link Corrections:

  • Updated image references and fixed various links to ensure they point to the correct and most up-to-date documentation.

These changes collectively enhance the documentation site's usability, making it easier for users—especially newcomers—to locate tools, guides, and technical references.

Test Plan

Confirm documentation builds correctly in local environment with no errors.

Test Result

Local build successful.

Submission Checklist

@mbenavidez-amd mbenavidez-amd self-assigned this Jun 23, 2026
@mbenavidez-amd mbenavidez-amd added the documentation Improvements or additions to documentation label Jun 23, 2026
@mbenavidez-amd mbenavidez-amd force-pushed the feature/cluster-redesign branch from 7cce2c2 to 8532aa2 Compare June 23, 2026 21:22
@mbenavidez-amd mbenavidez-amd force-pushed the feature/cluster-redesign branch from 8532aa2 to 9562135 Compare June 23, 2026 21:25
@mbenavidez-amd mbenavidez-amd force-pushed the feature/cluster-redesign branch from 2355e43 to da75660 Compare June 24, 2026 20:07
Comment thread docs/sphinx/_toc.yml.in

@AMD-melliott AMD-melliott left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes look good, just one link that needs to be fixed

@mbenavidez-amd mbenavidez-amd left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes look good, just one link that needs to be fixed

Updated.

@AMD-melliott AMD-melliott left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good work!

@AMD-melliott AMD-melliott merged commit 0e853af into ROCm:develop Jun 25, 2026
2 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants