chore: remove legacy docs/ (#5583)

Author: JoshuaKGoldberg

.eleventy.js

@@ -1,7 +1,5 @@
 # Mocha-specific
-docs/_site
 docs/images/supporters
-docs/api
 mocha.js
 mocha.js.map
 .karma/

.gitignore

@@ -4,6 +4,7 @@
     "bin/mocha.js!",
     "bin/_mocha!",
     "browser-entry.js!",
+    "docs/_data/supporters.js",
     "index.js!",
     "lib/cli/index.js!",
   ],
@@ -13,11 +14,9 @@
     "test/integration/fixtures/options/watch/test-with-dependency.fixture.js",
   ],
   "ignoreDependencies": [
-    "@mocha/docdash",
     "@test/esm-only-loader",
     "coffeescript",
     "fake",
-    "jsdoc-ts-utils",
     "non-existent-package",
   ],
   "mocha": {

.knip.jsonc

@@ -2,11 +2,6 @@
 /.nyc_output
 /CHANGELOG.md
 /coverage
-/docs/_site/
-/docs/api/
-/docs/css/normalize.css
-/docs/css/prism.css
-/docs/js/
 /pnpm-lock.yaml
 /test/*/fixtures/**
 

.prettierignore

@@ -1,35 +1,16 @@
 # Mocha Docs: Built on Astro Starlight
 
-This is the new site, hosted at https://mochajs.org/next and built with [Astro Starlight](https://starlight.astro.build). For details on how to build alongside the old site, see the `docs` directory.
+This is the current Mocha documentation website, hosted at [mochajs.org](https://mochajs.org) and built with [Astro Starlight](https://starlight.astro.build).
 
-## Preview the new site on its own
+> For details on the legacy site, see [https://github.com/mochajs/docs-legacy](mochajs/docs-legacy).
 
-To run this site alone:
+## Preview the new site
+
+To run this site:
 
 ```shell
 cd docs-next
 npm i
 npm run generate
 npm run dev
 ```
-
-## Build the new site into a folder with the old site
-
-```shell
-cd docs-next
-npm i
-npm run build-with-old
-```
-
-## Preview the old and new site together
-
-First, build the new site into a folder with the old site above.
-
-```shell
-cd .. # back to root dir
-npm run docs:preview
-```
-
-The new site will be at `http://localhost:8080/next`
-
-However, note that relative links may resolve with `dev` but fail with `build` and `preview` (see https://github.com/mochajs/mocha/issues/5415).

docs-next/README.md

@@ -0,0 +1 @@
+/api/* https://legacy.mochajs.org/api/:splat 301

docs-next/_redirects

@@ -1,22 +1,7 @@
 import { defineConfig } from "astro/config";
 import starlight from "@astrojs/starlight";
-import { visit } from "unist-util-visit";
-
-const base = "/next";
-
-/** Prepend base URL to non-`/api` absolute links */
-const rewriteLinks = ({ base }: { base: string }) => {
-  return (tree: any) => {
-    visit(tree, "link", (node) => {
-      if (node.url.startsWith("/") && !node.url.startsWith("/api")) {
-        node.url = base + node.url;
-      }
-    });
-  };
-};
 
 export default defineConfig({
-  base,
   integrations: [
     starlight({
       components: {
@@ -196,7 +181,4 @@ export default defineConfig({
       title: "Mocha",
     }),
   ],
-  markdown: {
-    remarkPlugins: [[rewriteLinks, { base }]],
-  },
 });

docs-next/astro.config.ts

@@ -1,11 +1,11 @@
 [build]
   command = "npm run docs"
-  publish = "dist/"
+  publish = "docs-next/dist/"
 
 [build.environment]
   DEBUG = "mocha:docs*"
-  NODE_VERSION = "20"
+  NODE_VERSION = "24"
 
 [context.deploy-preview]
   command = "npm run docs"
-  publish = "dist/"
+  publish = "docs-next/dist/"

docs-next/netlify.toml

@@ -5,9 +5,8 @@
   "scripts": {
     "astro": "astro",
     "build": "astro check && astro build",
-    "build-with-old": "npm run generate && npm run build -- --outDir ../docs/_site/next",
     "dev": "astro dev",
-    "docs": "cd .. && npm i && cd docs-next && npm run generate && npm run build",
+    "docs": "cd .. && npm i && cd docs-next && npm i && npm run generate && npm run build && cp _redirects dist/_redirects",
     "generate": "node ../docs/_data/supporters.js --write-supporters-json",
     "preview": "astro preview",
     "start": "astro dev"

docs-next/package.json

@@ -14,14 +14,15 @@ import Badges from "../../components/Badges.astro";
 import ClientRedirects from "../../components/ClientRedirects.astro";
 import Supporters from "../../components/Supporters.astro";
 
-:::note[New Site Preview]
+:::note[New Documentation Site]
 Hello!
-Welcome to this preview of a revamped [**mochajs.org**](https://mochajs.org) docs site!
+Welcome to the newly revamped mochajs.org!
 
-This is an early stage preview.
-If you see any **bugs** or **typos**, please [file a docs issue on mochajs/mocha](https://github.com/mochajs/mocha/issues/new?template=02-documentation.yml).
+If you see any bugs or typos, please [file a docs issue on mochajs/mocha](https://github.com/mochajs/mocha/issues/new?template=02-documentation.yml).
 Thanks!
 🤎
+
+_For the old docs website, see: [legacy.mochajs.org](https://legacy.mochajs.org)_.
 :::
 
 <Badges />
@@ -57,4 +58,4 @@ For a running example of Mocha, view [example/tests.html](example/tests.html).
 
 For the JavaScript API, view the [API documentation](/api) or the [source](https://github.com/mochajs/mocha/blob/main/lib/mocha.js).
 
-<ClientRedirects client:load />
+<ClientRedirects />