Skip to content

chore(docs): rename docs-next to docs#5770

Open
sudip-kumar-prasad wants to merge 1 commit intomochajs:mainfrom
sudip-kumar-prasad:fix-5676-rename-docs
Open

chore(docs): rename docs-next to docs#5770
sudip-kumar-prasad wants to merge 1 commit intomochajs:mainfrom
sudip-kumar-prasad:fix-5676-rename-docs

Conversation

@sudip-kumar-prasad
Copy link

@sudip-kumar-prasad sudip-kumar-prasad commented Feb 25, 2026

PR Checklist

Overview

This PR addresses issue #5676 by renaming the docs-next directory to docs. Since the Astro Starlight site has become the primary documentation for Mocha, the "next" suffix is no longer necessary. The legacy docs folder has been replaced.

Changes Made:

  • Moved docs/_data/supporters.js to the new docs directory as it's still required for generating the sponsors JSON.
  • Replaced the obsolete docs/ repository with docs-next/.
  • Updated all references pointing to docs-next across the codebase:
    • Modified package.json scripts at the root and inside the docs directory.
    • Updated .github/workflows/mocha.yml path triggers.
    • Updated eslint.config.js to correct the linting target.
    • Updated README.md and netlify.toml file paths.
  • Added debug as a devDependency in docs/package.json since supporters.js relies on it, fixing local ESLint errors.

Related Issues

Fixes #5676

Fixes mochajs#5676.

Replaces the legacy `docs` directory with the new `docs-next` Astro Starlight documentation site. Updates all references in GitHub workflows, npm scripts, and ESLint configuration to point to the new location.
Copilot AI review requested due to automatic review settings February 25, 2026 05:02
@linux-foundation-easycla
Copy link

linux-foundation-easycla bot commented Feb 25, 2026

CLA Signed
The committers listed above are authorized under a signed CLA.

  • ✅ login: sudip-kumar-prasad / name: Sudip Kumar Prasad (a571b76)

@github-actions

This comment has been minimized.

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR completes the transition from the legacy documentation site to Astro Starlight by renaming the docs-next/ directory to docs/. Since the Astro Starlight site is now the primary and only documentation for Mocha, the "-next" suffix is no longer needed.

Changes:

  • Renamed docs-next/ directory to docs/ across the entire codebase
  • Moved _data/supporters.js from legacy docs to the new docs directory
  • Added debug as a devDependency in docs/package.json since supporters.js requires it

Reviewed changes

Copilot reviewed 9 out of 121 changed files in this pull request and generated no comments.

Show a summary per file
File Description
package.json Updated root script to reference docs instead of docs-next
eslint.config.js Updated ignore pattern for docs directory
.github/workflows/mocha.yml Removed duplicate docs-next/** path trigger
README.md Updated logo image path to reference docs/
docs/README.md Updated directory reference in instructions
docs/package.json Updated package name, scripts, and added debug dependency
docs/package-lock.json Reflected package name change and new dependency
docs/netlify.toml Updated publish path to docs/dist/
docs/_data/supporters.js Reformatted code and updated comments to remove references to dual docs system
docs/* (new files) All Astro documentation site files properly added

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@mark-wiemer
Copy link
Member

Thanks @sudip-kumar-prasad :) we do already have a Copilot PR for this but I'm sure that one's gotten stale too. As you can see, this PR is also already stable. Unfortunately this rename isn't top priority right now, so we may be merging a lot of different things that repeatedly make this PR stale. I'll see if I can check this out this weekend and close it out though, appreciate your patience!

@mark-wiemer mark-wiemer self-assigned this Feb 27, 2026
@mark-wiemer mark-wiemer added this to the Chores milestone Feb 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

🛠️ Repo: Rename docs-next/ to docs/

3 participants