Volcano Website: Docusaurus migration POC with scheduler docs, versioning, CI, and UI revamp

[aaradhychinche-alt]

Volcano Website: Docusaurus Migration Proof of Concept

Summary

This PR provides an early proof-of-concept for migrating the Volcano website from Hugo to Docusaurus and modernizing the documentation experience.

It includes:

• Migration of scheduler documentation for v1.12 with plugins and actions split into dedicated pages
• Hugo shortcode replacement using MDX React components
• GitHub Actions workflow for validating docs builds
• Docusaurus versioning enabled with a v1.12 snapshot
• Initial Volcano-branded homepage and navigation redesign
• Animated hero visualization for scheduler topology
• Production build verification

---

Motivation

The current Hugo-based site is difficult to extend and lacks modern features such as first-class versioning, component-driven documentation, and automated validation.

This PR explores the feasibility of:

• a Hugo → Docusaurus migration
• restructuring scheduler documentation
• improving navigation and UX
• enforcing builds via CI
• introducing a modern CNCF-style docs portal

---

Related Mentorship Project & Issues

This work is part of the LFX mentorship project:

Volcano documentation & website revamp with Docusaurus

Related issues:

• New Theme for the Website [ Docusurus ] #398
• Docs(Plugins): Refactor plugins item to be a submenu of Scheduler #425
• Docs(Plugins): Synchronize plugin documentation with the main volcano repository #427

---

Scope

This is a draft / exploratory PR intended to gather early feedback from maintainers before completing the full migration.

---

Follow-ups

Future work would include:

• migrating remaining documentation sections
• importing older versions
• Chinese localization (i18n)
• automated doc-sync tooling
• contributor documentation improvements

---

Testing

• npm run build succeeds locally
• GitHub Actions workflow added to validate docs builds

---

Notes for Maintainers

Feedback on the following areas would be especially valuable:

• overall site structure and navigation
• feasibility of the Docusaurus migration approach
• scheduler docs layout and organization
• UI direction for the homepage
• versioning strategy

Thank you for taking the time to review this exploratory PR.

[volcano-sh-bot]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign william-wang for approval. For more information see the Kubernetes Code Review Process.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[gemini-code-assist]

Summary of Changes

Hello @aaradhychinche-alt, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request marks a foundational step in enhancing the Volcano project's online presence and documentation infrastructure. By transitioning to Docusaurus, the project gains a more robust and feature-rich platform capable of supporting advanced documentation needs like versioning and component-driven content. The changes encompass a significant overhaul of the scheduler documentation, a fresh UI design, and the establishment of automated quality checks, all contributing to a more maintainable and user-friendly website.

Highlights

• Docusaurus Migration Proof-of-Concept: This pull request initiates a proof-of-concept for migrating the Volcano website from Hugo to Docusaurus, aiming to modernize the documentation experience and address limitations of the previous platform.
• Comprehensive Scheduler Documentation: Detailed documentation for Volcano scheduler actions (Allocate, Backfill, Enqueue, Preempt, Reclaim) and plugins (Binpack, DRF, Gang, Nodeorder, Numa-aware, Predicates, Priority, Proportion, SLA, TDM, Task-topology) has been added, providing in-depth explanations of their functionality and scenarios.
• Documentation Versioning Enabled: Docusaurus's built-in versioning feature has been configured, with an initial snapshot for v1.12 of the scheduler documentation, allowing for better management and presentation of content across different software releases.
• UI Revamp and Branding: The website's user interface has been revamped with Volcano branding, including a custom CSS theme, a redesigned homepage with animated elements (terminal install, scheduler visualization), and improved navigation.
• Automated Build Validation: A GitHub Actions workflow has been integrated to validate documentation builds, ensuring that changes do not introduce errors and maintaining the quality of the website.
• Hugo Shortcode Replacement with MDX: Custom React components, such as a Figure component, have been introduced to replace Hugo shortcodes, leveraging Docusaurus's MDX capabilities for more flexible and interactive content.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog

• volcano-docs-docusaurus/.gitignore
  • Added a .gitignore file to exclude common build artifacts and dependencies specific to Docusaurus projects.
• volcano-docs-docusaurus/README.md
  • Provided comprehensive instructions for setting up, running, building, and deploying the new Docusaurus site locally.
• volcano-docs-docusaurus/blog/2019-05-28-first-blog-post.md
  • Included a boilerplate blog post to demonstrate Docusaurus's blogging features.
• volcano-docs-docusaurus/blog/2019-05-29-long-blog-post.md
  • Added a longer boilerplate blog post, showcasing the truncate feature for summaries.
• volcano-docs-docusaurus/blog/2021-08-01-mdx-blog-post.mdx
  • Included an example MDX blog post demonstrating interactive React components within Markdown.
• volcano-docs-docusaurus/blog/2021-08-26-welcome/index.md
  • Added a welcome blog post, detailing Docusaurus blogging features and structure.
• volcano-docs-docusaurus/blog/authors.yml
  • Configured example author profiles for blog posts.
• volcano-docs-docusaurus/blog/tags.yml
  • Defined example tags for blog post categorization.
• volcano-docs-docusaurus/docs/intro.md
  • Added the introductory tutorial for Docusaurus basics, guiding users through initial setup.
• volcano-docs-docusaurus/docs/scheduler/actions/allocate.md
  • Introduced documentation for the 'Allocate' scheduler action, explaining its overview and scenarios.
• volcano-docs-docusaurus/docs/scheduler/actions/backfill.md
  • Added documentation for the 'Backfill' scheduler action, covering its purpose and use cases.
• volcano-docs-docusaurus/docs/scheduler/actions/enqueue.md
  • Created documentation for the 'Enqueue' scheduler action, detailing its overview, scenarios, and potential conflicts.
• volcano-docs-docusaurus/docs/scheduler/actions/preempt.md
  • Provided documentation for the 'Preempt' scheduler action, outlining its overview and preemption scenarios.
• volcano-docs-docusaurus/docs/scheduler/actions/reclaim.md
  • Added documentation for the 'Reclaim' scheduler action, explaining its cross-queue resource reclamation and optimization scenarios.
• volcano-docs-docusaurus/docs/scheduler/intro.md
  • Created an overview page for the Volcano Scheduler, explaining its architecture, plugins, and actions.
• volcano-docs-docusaurus/docs/scheduler/plugins/binpack.md
  • Introduced documentation for the 'Binpack' scheduler plugin, describing its goal and scenarios.
• volcano-docs-docusaurus/docs/scheduler/plugins/drf.md
  • Added documentation for the 'DRF' (Dominant Resource Fairness) scheduler plugin, detailing its overview and scenarios.
• volcano-docs-docusaurus/docs/scheduler/plugins/gang.md
  • Created documentation for the 'Gang' scheduler plugin, explaining its 'All or nothing' scheduling strategy and use cases.
• volcano-docs-docusaurus/docs/scheduler/plugins/nodeorder.md
  • Provided documentation for the 'Nodeorder' scheduler plugin, covering its overview and scenario for multi-dimensional scoring.
• volcano-docs-docusaurus/docs/scheduler/plugins/numa-aware.md
  • Added documentation for the 'Numa-aware' scheduler plugin, addressing CPU topology scheduling limitations and scenarios.
• volcano-docs-docusaurus/docs/scheduler/plugins/predicates.md
  • Introduced documentation for the 'Predicates' scheduler plugin, explaining its role in pre-selecting jobs based on criteria like GPU requirements.
• volcano-docs-docusaurus/docs/scheduler/plugins/priority.md
  • Added documentation for the 'Priority' scheduler plugin, detailing its job and task sorting capabilities and fair-share scenarios.
• volcano-docs-docusaurus/docs/scheduler/plugins/proportion.md
  • Created documentation for the 'Proportion' scheduler plugin, describing its queue-based resource allocation and multi-team scenarios.
• volcano-docs-docusaurus/docs/scheduler/plugins/sla.md
  • Provided documentation for the 'SLA' scheduler plugin, outlining its function in setting service level agreements for jobs.
• volcano-docs-docusaurus/docs/scheduler/plugins/task-topology.md
  • Added documentation for the 'Task-topology' scheduler plugin, explaining its affinity and anti-affinity algorithms for task placement.
• volcano-docs-docusaurus/docs/scheduler/plugins/tdm.md
  • Introduced documentation for the 'TDM' (Time Division Multiplexing) scheduler plugin, detailing its use in co-located environments and resource utilization improvement.
• volcano-docs-docusaurus/docs/tutorial-basics/category.json
  • Defined the category metadata for the 'Tutorial - Basics' section in the sidebar.
• volcano-docs-docusaurus/docs/tutorial-basics/congratulations.md
  • Added the 'Congratulations!' page for the Docusaurus basic tutorial.
• volcano-docs-docusaurus/docs/tutorial-basics/create-a-blog-post.md
  • Included a tutorial page on how to create a blog post in Docusaurus.
• volcano-docs-docusaurus/docs/tutorial-basics/create-a-document.md
  • Added a tutorial page on how to create a document and configure sidebars in Docusaurus.
• volcano-docs-docusaurus/docs/tutorial-basics/create-a-page.md
  • Included a tutorial page on creating standalone pages using Markdown or React in Docusaurus.
• volcano-docs-docusaurus/docs/tutorial-basics/deploy-your-site.md
  • Added a tutorial page on building and deploying a Docusaurus site.
• volcano-docs-docusaurus/docs/tutorial-basics/markdown-features.mdx
  • Included a tutorial page detailing Markdown features and MDX capabilities in Docusaurus.
• volcano-docs-docusaurus/docs/tutorial-extras/category.json
  • Defined the category metadata for the 'Tutorial - Extras' section in the sidebar.
• volcano-docs-docusaurus/docs/tutorial-extras/manage-docs-versions.md
  • Added a tutorial page on managing documentation versions in Docusaurus.
• volcano-docs-docusaurus/docs/tutorial-extras/translate-your-site.md
  • Included a tutorial page on translating a Docusaurus site using i18n features.
• volcano-docs-docusaurus/docusaurus.config.ts
  • Configured the Docusaurus site with Volcano branding, including title, tagline, favicon, base URL, and GitHub repository links.
  • Enabled Docusaurus docs and blog presets, specifying sidebar paths and edit URLs.
  • Set up future flags for Docusaurus v4 compatibility and configured i18n for English.
  • Defined the navbar structure with links to documentation and GitHub, including a version dropdown.
  • Configured the footer with links to documentation, community resources, and copyright information.
  • Set up Prism themes for code highlighting in both light and dark modes.
• volcano-docs-docusaurus/package.json
  • Initialized package.json with Docusaurus dependencies and scripts for development, building, and deployment.
  • Specified Node.js version requirement (>=20.0) and browserslist configuration.
• volcano-docs-docusaurus/sidebars.ts
  • Defined the main navigation sidebar structure, organizing tutorials and detailed scheduler documentation (plugins and actions) into logical categories.
• volcano-docs-docusaurus/src/components/HomepageFeatures/index.tsx
  • Included boilerplate React components for displaying homepage features.
• volcano-docs-docusaurus/src/components/HomepageFeatures/styles.module.css
  • Added CSS styling for the homepage feature components.
• volcano-docs-docusaurus/src/components/shortcodes/Figure.tsx
  • Created a custom React Figure component to replace Hugo shortcodes for rendering images with titles and alt text.
• volcano-docs-docusaurus/src/css/custom.css
  • Implemented a custom CSS theme with Volcano branding, including a color system (charcoal, lava, ember), hero section styling with gradients, terminal styles, feature card designs, use case blocks, and plugin card styles.
  • Added responsive design adjustments for various screen sizes.
• volcano-docs-docusaurus/src/pages/index.module.css
  • Added CSS for the homepage hero banner and button styling.
• volcano-docs-docusaurus/src/pages/index.tsx
  • Developed a new Docusaurus homepage featuring animated terminal installation, an SVG visualization of the scheduler, feature grids highlighting key capabilities, use case blocks, and a plugin explorer section.
• volcano-docs-docusaurus/src/pages/markdown-page.md
  • Included a sample standalone Markdown page to demonstrate basic page creation.
• volcano-docs-docusaurus/static/img/logo.svg
  • Added the Volcano logo SVG asset.
• volcano-docs-docusaurus/static/img/undraw_docusaurus_mountain.svg
  • Added an SVG illustration for Docusaurus features.
• volcano-docs-docusaurus/static/img/undraw_docusaurus_react.svg
  • Added an SVG illustration related to React for Docusaurus features.
• volcano-docs-docusaurus/static/img/undraw_docusaurus_tree.svg
  • Added an SVG illustration for Docusaurus features.
• volcano-docs-docusaurus/tsconfig.json
  • Added TypeScript configuration for the Docusaurus project, extending @docusaurus/tsconfig.
• volcano-docs-docusaurus/versioned_docs/version-1.12/intro.md
  • Created a versioned copy of the Docusaurus introductory tutorial for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/migration/migration-audit.md
  • Added a migration audit document for v1.12, detailing Hugo shortcodes, docs directories, versioning, front matter, Netlify config, and Markdown rendering.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/actions/allocate.md
  • Created a versioned copy of the 'Allocate' scheduler action documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/actions/backfill.md
  • Created a versioned copy of the 'Backfill' scheduler action documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/actions/enqueue.md
  • Created a versioned copy of the 'Enqueue' scheduler action documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/actions/preempt.md
  • Created a versioned copy of the 'Preempt' scheduler action documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/actions/reclaim.md
  • Created a versioned copy of the 'Reclaim' scheduler action documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/intro.md
  • Created a versioned copy of the Volcano Scheduler overview documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/plugins/binpack.md
  • Created a versioned copy of the 'Binpack' scheduler plugin documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/plugins/drf.md
  • Created a versioned copy of the 'DRF' scheduler plugin documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/plugins/gang.md
  • Created a versioned copy of the 'Gang' scheduler plugin documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/plugins/nodeorder.md
  • Created a versioned copy of the 'Nodeorder' scheduler plugin documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/plugins/numa-aware.md
  • Created a versioned copy of the 'Numa-aware' scheduler plugin documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/plugins/predicates.md
  • Created a versioned copy of the 'Predicates' scheduler plugin documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/plugins/priority.md
  • Created a versioned copy of the 'Priority' scheduler plugin documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/plugins/proportion.md
  • Created a versioned copy of the 'Proportion' scheduler plugin documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/plugins/sla.md
  • Created a versioned copy of the 'SLA' scheduler plugin documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/plugins/task-topology.md
  • Created a versioned copy of the 'Task-topology' scheduler plugin documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/scheduler/plugins/tdm.md
  • Created a versioned copy of the 'TDM' scheduler plugin documentation for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/tutorial-basics/category.json
  • Defined the category metadata for the versioned 'Tutorial - Basics' section for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/tutorial-basics/congratulations.md
  • Created a versioned copy of the 'Congratulations!' tutorial page for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/tutorial-basics/create-a-blog-post.md
  • Created a versioned copy of the 'Create a Blog Post' tutorial page for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/tutorial-basics/create-a-document.md
  • Created a versioned copy of the 'Create a Document' tutorial page for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/tutorial-basics/create-a-page.md
  • Created a versioned copy of the 'Create a Page' tutorial page for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/tutorial-basics/deploy-your-site.md
  • Created a versioned copy of the 'Deploy your site' tutorial page for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/tutorial-basics/markdown-features.mdx
  • Created a versioned copy of the 'Markdown Features' tutorial page for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/tutorial-extras/category.json
  • Defined the category metadata for the versioned 'Tutorial - Extras' section for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/tutorial-extras/manage-docs-versions.md
  • Created a versioned copy of the 'Manage Docs Versions' tutorial page for v1.12.
• volcano-docs-docusaurus/versioned_docs/version-1.12/tutorial-extras/translate-your-site.md
  • Created a versioned copy of the 'Translate your site' tutorial page for v1.12.
• volcano-docs-docusaurus/versioned_sidebars/version-1.12-sidebars.json
  • Generated a versioned sidebar configuration for v1.12 documentation, mirroring the main sidebar structure.
• volcano-docs-docusaurus/versions.json
  • Initialized the versions.json file to manage documentation versions, listing '1.12' as the first version.

Ignored Files

• Ignored by pattern: .github/workflows/** (1)
  • .github/workflows/docs-build.yml

Activity

• This pull request introduces a new Docusaurus-based website and documentation structure. As a proof-of-concept, it primarily involves initial setup and content migration.
• The author has added a comprehensive set of documentation for Volcano's scheduler plugins and actions, organized into a new structure.
• New UI components and custom styling have been implemented for the homepage, enhancing the visual appeal and user experience.
• Docusaurus versioning has been configured, with a snapshot of the v1.12 documentation created.
• A GitHub Actions workflow has been set up to automatically validate documentation builds, ensuring the integrity of the new site.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This is an excellent proof-of-concept for migrating the Volcano website to Docusaurus. The new homepage is a significant improvement with its modern design and engaging animations. The documentation for the scheduler has been well-structured into plugins and actions, which will make it much easier for users to navigate. The use of versioning and CI for build validation are also great additions.

My review includes a few critical and medium-severity suggestions to improve the project's stability, maintainability, and correctness before the full migration. These include addressing a corrupted logo file, using stable dependencies, removing placeholder configurations, and improving code style by avoiding inline styles. Overall, this is a very strong start and a promising direction for the Volcano website.

[gemini-code-assist]

The logo.svg file appears to be corrupted or incorrectly generated. It seems to contain elements of the Docusaurus "keytar" logo underneath a white rectangle. This should be corrected to use a clean version of the Volcano logo to ensure proper branding and avoid any potential licensing issues with embedded assets.

[gemini-code-assist]

The project is configured to use React 19, which is currently in a release candidate stage. Using pre-release versions of core dependencies like React in a production project is risky and can lead to unexpected issues and breaking changes. It's recommended to use the latest stable version of React 18, which is officially supported by Docusaurus v3, to ensure stability.

Suggested change

	"react": "^19.0.0",
	"react-dom": "^19.0.0"
	"react": "^18.0.0",
	"react-dom": "^18.0.0"

[gemini-code-assist]

The url field in the configuration is set to a placeholder value. This should be updated to the actual production URL of the website to ensure that metadata, sitemaps, and canonical URLs are generated correctly.

Suggested change

	url: 'https://your-docusaurus-site.example.com',
	url: 'https://volcano.sh',

[gemini-code-assist]

The editUrl for the blog is pointing to a placeholder URL from the Docusaurus template repository. This should be updated to point to the correct location in the Volcano project repository to allow users to easily suggest edits to blog posts.

Suggested change

	editUrl:
	'https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/',
	editUrl:
	'https://github.com/volcano-sh/website/tree/main/volcano-docs-docusaurus/',

[gemini-code-assist]

The image property in themeConfig is using a placeholder social card image from Docusaurus. This should be replaced with a Volcano-branded image to ensure proper branding when links to the site are shared on social media.

Suggested change

	image: 'img/docusaurus-social-card.jpg',
	image: 'img/volcano-social-card.jpg',

[gemini-code-assist]

Some of the links in the footer, such as 'Architecture' and 'Getting Started', point to the placeholder /docs/intro page. These should be updated to point to the correct, relevant pages once they are created to improve site navigation.

            {
              label: 'Architecture',
              to: '/docs/architecture', // TODO: Update to correct path
            },
            {
              label: 'Getting Started',
              to: '/docs/getting-started', // TODO: Update to correct path
            },

[gemini-code-assist]

The Figure component uses inline styles for layout and presentation. It's a best practice to move these styles into a dedicated CSS module (.module.css). This improves maintainability, allows for easier theming (e.g., for dark mode), and separates concerns between component logic and styling.

For example, you could create a Figure.module.css file with the following content:

.figure {
  text-align: center;
  margin: 1.5rem 0;
}

.figureImg {
  height: auto;
  display: block;
  margin: 0 auto;
}

.figureCaption {
  margin-top: 0.5rem;
  font-style: italic;
  color: #666;
}

[data-theme='dark'] .figureCaption {
  color: #9e9e9e;
}

And then update the component to use these classes:

import React from 'react';
import styles from './Figure.module.css';

// ... (interface remains the same)

const Figure: React.FC<FigureProps> = ({ src, title, alt, width }) => {
    return (
        <figure className={styles.figure}>
            <img
                src={src}
                alt={alt || title || 'Figure'}
                className={styles.figureImg}
                style={{ maxWidth: width || '100%' }}
            />
            {title && (
                <figcaption className={styles.figureCaption}>
                    {title}
                </figcaption>
            )}
        </figure>
    );
};

[gemini-code-assist]

The HomepageHero component uses inline styles for font sizes and margins. To improve maintainability and ensure a consistent design system, it's better to move these styles to the corresponding CSS module (index.module.css). This keeps styling separate from the component's logic and makes it easier to manage theme changes.

For example, you could add these classes to index.module.css:

.heroTitle {
  font-size: 3.5rem;
  margin-bottom: 1rem;
}

.heroSubtitle {
  font-size: 1.3rem;
  margin-bottom: 2rem;
}

And then apply them in your component:

<Heading as="h1" className={clsx('hero__title', styles.heroTitle)}>
  Volcano
</Heading>
<p className={clsx('hero__subtitle', styles.heroSubtitle)}>
  Cloud-Native Batch Scheduling for Kubernetes and AI Workloads
</p>

[codeEvolveZenith345]

The preview does not show it is functionally Docusaurus; please add the .docusaurus and .config files that Docusaurus uses for the build, or else this PR does not make any sense? You just changed file/folder name...based on the Netlify preview.

[aaradhychinche-alt]

The preview does not show it is functionally Docusaurus; please add the .docusaurus and .config files that Docusaurus uses for the build, or else this PR does not make any sense? You just changed file/folder name...based on the Netlify preview.

Thanks for calling that out — agreed that the preview was misleading.

I’ve added:

A Netlify config that builds the Docusaurus site from volcano-docs-docusaurus/

Root-level migration docs explaining the structure and rollout plan

Validation + quick-start instructions

CI confirmation

The preview should now reflect the Docusaurus build instead of Hugo.

[volcano-sh-bot]

Keywords which can automatically close issues and at(@) or hashtag(#) mentions are not allowed in commit messages.

The list of commits with invalid commit messages:

• 9db8962 chore: sync lockfile for Netlify npm ci compatibility

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository. I understand the commands that are listed here.