chore(docs): rename docs-next to docs

[sudip-kumar-prasad]

PR Checklist

• Addresses an existing open issue: fixes 🛠️ Repo: Rename docs-next/ to docs/ #5676
• That issue was marked as status: accepting prs
• Steps in CONTRIBUTING.md were taken

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

[linux-foundation-easycla]

The committers listed above are authorized under a signed CLA.

• ✅ login: mark-wiemer / name: Mark Wiemer (e31300a, 6c7b5a7)
• ✅ login: sudip-kumar-prasad / name: Sudip Kumar Prasad (8bbc6fa, d9c6df8, df10412)

[Copilot]

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]

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!

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.70%. Comparing base (2e07be1) to head (e31300a).
⚠️ Report is 9 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #5770      +/-   ##
==========================================
+ Coverage   88.73%   89.70%   +0.96%     
==========================================
  Files          66       64       -2     
  Lines        4742     4691      -51     
  Branches      976      976              
==========================================
  Hits         4208     4208              
+ Misses        534      483      -51     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[mark-wiemer]

Approved under the condition I can go into Netlify and fixup the base path. I think we maintainers generally agree that we minimize root-level files as much as possible, it just looks so messy.

[mark-wiemer]

Changed Netlify to use docs as base path (previous value was docs-next). Going to update this PR similarly.

[mark-wiemer]

Thank you!