chore: docs updates

lerna · Jun 2, 2023 · a6be819 · a6be819
1 parent 52c11ed
commit a6be819
Show file tree

Hide file tree

Showing 14 changed files with 119 additions and 680 deletions.
diff --git a/README.md b/README.md
@@ -47,15 +47,15 @@ A few links to help you get started:
 - [lerna.js.org: Documentation, Guides, Interactive Tutorials](https://lerna.js.org)
 - [Getting Started](https://lerna.js.org/docs/getting-started)
 - [Features](https://lerna.js.org/docs/features)
-- [Official Nrwl YouTube Channel](https://www.youtube.com/c/Nrwl_io)
+- [Official Nx and Lerna YouTube Channel](https://www.youtube.com/@nxdevtools)
 - [Blog Posts About Lerna and Nx](https://blog.nrwl.io/nx/home)
 
 <br />
 
 ## Engage with the Core Team and the Community
 
-- [Nrwl Community Slack, #lerna channel](https://go.nrwl.io/join-slack)
-- [Follow Nrwl on Twitter](https://twitter.com/nrwl_io)
+- [Follow Lerna on Twitter](https://twitter.com/lernajs)
+- [Community Slack, #lerna channel](https://go.nrwl.io/join-slack)
 
 ### Want to help?
 

diff --git a/doc/guides.md b/doc/guides.md
diff --git a/doc/hoist.md b/doc/hoist.md
diff --git a/doc/troubleshooting.md b/doc/troubleshooting.md
diff --git a/packages/lerna/src/index.ts b/packages/lerna/src/index.ts
@@ -67,15 +67,30 @@ function applyLegacyPackageManagementCommands(yargsInstance: ReturnType<typeof l
   } catch {
     ["add", "bootstrap", "link"].forEach((commandName) => {
       yargsInstance.command({
-        command: commandName,
-        describe: `The "${commandName}" command was removed in v7, and is no longer maintained.`,
+        command: commandName === "add" ? "add <pkg> [globs..]" : commandName,
+        describe: `The "${commandName}" command was removed by default in v7, and is no longer maintained.`,
+        builder: (yargs) => {
+          /**
+           * Dynamically parse all given flags and apply them as options, so that our handler() is always called,
+           * rather than yargs showing options based validation messaging.
+           */
+          const parsed = require("yargs/yargs")(process.argv.slice(2)).argv;
+          for (const x of Object.keys(parsed)) {
+            if (x !== "_" && x !== "$0") {
+              yargs.option(x, {});
+            }
+          }
+          return yargs;
+        },
         handler() {
           log.error(
             commandName,
-            `The "${commandName}" command was removed in v7, and is no longer maintained.`
+            `The "${commandName}" command was removed by default in v7, and is no longer maintained.`
+          );
+          log.error(
+            commandName,
+            `Learn more about this change at https://lerna.js.org/docs/legacy-package-management`
           );
-          // TODO: in v7 link to a specific guide
-          log.error(commandName, `Learn more about this change at https://lerna.js.org`);
           process.exit(1);
         },
       });

diff --git a/website/docs/api-reference/commands.md b/website/docs/api-reference/commands.md
@@ -6,23 +6,20 @@ type: reference
 
 # Commands
 
-- [`lerna publish`](https://github.com/lerna/lerna/tree/main/libs/commands/publish#readme)
-- [`lerna version`](https://github.com/lerna/lerna/tree/main/libs/commands/version#readme)
-- [`lerna bootstrap`](https://github.com/lerna/lerna/tree/main/libs/commands/bootstrap#readme)
-- [`lerna list`](https://github.com/lerna/lerna/tree/main/libs/commands/list#readme)
+- [`lerna add-caching`](https://github.com/lerna/lerna/tree/main/packages/lerna/src/commands/add-caching#readme)
 - [`lerna changed`](https://github.com/lerna/lerna/tree/main/libs/commands/changed#readme)
+- [`lerna clean`](https://github.com/lerna/lerna/tree/main/libs/commands/clean#readme)
+- [`lerna create`](https://github.com/lerna/lerna/tree/main/libs/commands/create#readme)
 - [`lerna diff`](https://github.com/lerna/lerna/tree/main/libs/commands/diff#readme)
 - [`lerna exec`](https://github.com/lerna/lerna/tree/main/libs/commands/exec#readme)
-- [`lerna run`](https://github.com/lerna/lerna/tree/main/libs/commands/run#readme)
-- [`lerna init`](https://github.com/lerna/lerna/tree/main/libs/commands/init#readme)
-- [`lerna add`](https://github.com/lerna/lerna/tree/main/libs/commands/add#readme)
-- [`lerna clean`](https://github.com/lerna/lerna/tree/main/libs/commands/clean#readme)
 - [`lerna import`](https://github.com/lerna/lerna/tree/main/libs/commands/import#readme)
-- [`lerna link`](https://github.com/lerna/lerna/tree/main/libs/commands/link#readme)
-- [`lerna create`](https://github.com/lerna/lerna/tree/main/libs/commands/create#readme)
 - [`lerna info`](https://github.com/lerna/lerna/tree/main/libs/commands/info#readme)
-- [`lerna add-caching`](https://github.com/lerna/lerna/tree/main/packages/lerna/src/commands/add-caching#readme)
+- [`lerna init`](https://github.com/lerna/lerna/tree/main/libs/commands/init#readme)
+- [`lerna list`](https://github.com/lerna/lerna/tree/main/libs/commands/list#readme)
+- [`lerna publish`](https://github.com/lerna/lerna/tree/main/libs/commands/publish#readme)
 - [`lerna repair`](https://github.com/lerna/lerna/tree/main/packages/lerna/src/commands/repair#readme)
+- [`lerna run`](https://github.com/lerna/lerna/tree/main/libs/commands/run#readme)
+- [`lerna version`](https://github.com/lerna/lerna/tree/main/libs/commands/version#readme)
 - [`lerna watch`](https://github.com/lerna/lerna/tree/main/packages/lerna/src/commands/watch#readme)
 
 ## Filter Options