@teambit/harmony.content.cli-reference 1.95.201 → 1.95.203

package/dist/cli-reference.json

@@ -31,32 +31,32 @@
             [
                 "",
                 "reset-lane-new",
-                "same as reset-new, but it only reset components belong to lanes. main components are left intact"
+                "same as reset-new, but it only resets components belong to lanes. main components are left intact"
             ],
             [
                 "",
                 "reset-hard",
-                "delete all Bit files and directories, including Bit configuration, tracking and model data. Useful for re-start using Bit from scratch"
+                "delete all Bit files and directories, including Bit configuration, tracking and model data. Useful for re-starting workspace from scratch"
             ],
             [
                 "",
                 "reset-scope",
-                "removes local scope (.bit or .git/bit). snaps that were not exported will be lost. workspace left intact"
+                "removes local scope (.bit or .git/bit). tags/snaps that have not been exported will be lost. workspace is left intact"
             ],
             [
                 "d",
                 "default-directory <default-directory>",
-                "set up default directory to import components into"
+                "set the default directory pattern to import/create components into"
             ],
             [
                 "",
                 "default-scope <default-scope>",
-                "set up default scope for all components in the workspace"
+                "set the default scope for components in the workspace"
             ],
             [
                 "p",
                 "package-manager <package-manager>",
-                "set up package manager (npm or yarn)"
+                "set the package manager (npm or yarn) to be used in the workspace"
             ],
             [
                 "f",
@@ -112,7 +112,7 @@
                 "name": "get <key>",
                 "alias": "",
                 "options": [],
-                "description": "get a global configuration",
+                "description": "get a value from global configuration",
                 "extendedDescription": "",
                 "group": "ungrouped",
                 "private": false
@@ -139,7 +139,7 @@
             ]
         ],
         "description": "manage set of tracked bit scope(s)",
-        "extendedDescription": "https://bit.dev/docs/scope/remote-scopes",
+        "extendedDescription": "",
         "group": "collaborate",
         "private": false,
         "commands": [
@@ -165,7 +165,7 @@
                     [
                         "g",
                         "global",
-                        "remove a global configured remote scope"
+                        "remove a globally configured remote scope"
                     ]
                 ],
                 "description": "remove a tracked bit remote",
@@ -507,7 +507,7 @@
             [
                 "",
                 "machine-name <name>",
-                "specify machine-name to pair with the token (useful for CI to avoid accidentally revoke the token)"
+                "specify machine-name to pair with the token (useful for CI to avoid accidentally revoking the token)"
             ]
         ],
         "description": "log in to Bit cloud",
@@ -697,7 +697,7 @@
             [
                 "j",
                 "json",
-                "return the component data in a json format"
+                "return the component data in json format"
             ],
             [
                 "l",
@@ -707,12 +707,12 @@
             [
                 "r",
                 "remote",
-                "show a remote component"
+                "show data for a remote component"
             ],
             [
                 "c",
                 "compare",
-                "compare current file system component to the latest tagged component [default=latest]. only works in legacy."
+                "legacy-only. compare current file system component to its latest tagged version [default=latest]"
             ]
         ],
         "description": "display the component's essential information",
@@ -733,7 +733,7 @@
             [
                 "j",
                 "json",
-                "json format"
+                "output issues in json format"
             ]
         ],
         "description": "list available component-issues",
@@ -754,7 +754,7 @@
                 "name": "list",
                 "alias": "",
                 "options": [],
-                "description": "list all envs available in the workspace",
+                "description": "list all envs currently used in the workspace",
                 "extendedDescription": "",
                 "group": "development",
                 "private": false
@@ -769,21 +769,21 @@
                         "show information about the specific services only. for multiple services, separate by a comma and wrap with quotes"
                     ]
                 ],
-                "description": "show information about a component's env",
+                "description": "show config information from a component's env",
                 "extendedDescription": "",
                 "group": "development",
                 "private": false,
                 "arguments": [
                     {
                         "name": "component-name",
-                        "description": "the 'component name' or 'component id' of the component its env you'd like to inspect"
+                        "description": "the 'component name' or 'component id' of the component whose env you'd like to inspect"
                     }
                 ]
             },
             {
                 "name": "set <component-pattern> <env>",
                 "options": [],
-                "description": "Sets one or more components with a development environment (env)",
+                "description": "Assigns one or more components a development environment (env)",
                 "group": "development",
                 "arguments": [
                     {
@@ -792,21 +792,21 @@
                     },
                     {
                         "name": "env",
-                        "description": "the env's component id (include version for non-core envs. e.g, `teambit.community/envs/community-react@1.95.13`)"
+                        "description": "the env's component id (include version if not latest, e.g `teambit.community/envs/community-react@1.95.13`)"
                     }
                 ],
                 "examples": [
                     {
-                        "cmd": "set ui/button teambit.react/react",
-                        "description": "configures 'ui/button' to use the 'teambit.react/react' env"
+                        "cmd": "set ui/button teambit.react/react-env",
+                        "description": "configures 'ui/button' to use the latest version of the 'teambit.react/react-env' env"
                     },
                     {
                         "cmd": "set ui/button teambit.community/envs/community-mdx@1.95.16",
-                        "description": "configures 'ui/button' to use the (non-core) 'teambit.community/envs/community-mdx@1.95.16' env"
+                        "description": "configures 'ui/button' to use the 'teambit.community/envs/community-mdx@1.95.16' env"
                     },
                     {
-                        "cmd": "set \"ui/**\" teambit.react/react",
-                        "description": "configures all components that have the 'ui' namespace to use the teambit.react/react env"
+                        "cmd": "set \"ui/**\" teambit.react/react-env",
+                        "description": "configures all components that have the 'ui' namespace to use the latest version of the teambit.react/react-env env"
                     }
                 ]
             },
@@ -814,12 +814,12 @@
                 "name": "unset <component-pattern>",
                 "options": [],
                 "description": "un-sets an env from components that were previously set by \"bit env set\" or by a component template",
-                "extendedDescription": "keep in mind that this doesn't remove envs that are set in the variants.\nin only removes envs that appear in the .bitmap file, which were previously configured via \"bit env set\".\nthe purpose of this command is to remove the specific settings and let the the variants in workspace.jsonc to control the env.\nyou can use a `<pattern>` for multiple component ids, such as `bit env unset \"org.scope/utils/**\"`.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.\n",
+                "extendedDescription": "keep in mind that this doesn't remove envs that are set via variants.\nin only removes envs that appear in the .bitmap file, which were previously configured via \"bit env set\".\nthe purpose of this command is to reset previously assigned envs to either allow variants configure the env or use the base node env.\nyou can use a `<pattern>` for multiple component ids, such as `bit env unset \"org.scope/utils/**\"`.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.\n",
                 "group": "development",
                 "arguments": [
                     {
                         "name": "component-pattern",
-                        "description": "component name, component id, or component pattern. use component pattern to select multiple components. \nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+                        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
                     }
                 ]
             },
@@ -831,7 +831,7 @@
                 "arguments": [
                     {
                         "name": "current-env",
-                        "description": "the component id of the current env"
+                        "description": "the component id of the env to be replaced"
                     },
                     {
                         "name": "new-env",
@@ -853,21 +853,21 @@
                 "arguments": [
                     {
                         "name": "env-id",
-                        "description": "the environment id (defaults to all envs). optionally, add a version (id@version), otherwise, it finds the latest version on the remote."
+                        "description": "the environment id (defaults to all envs). optionally, add a version (id@version), if no version is supplied will use the latest version on the remote."
                     },
                     {
                         "name": "pattern",
-                        "description": "the components to update (defaults to all components). use component name, component id, or component pattern. use component pattern to select multiple components. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\". wrap the pattern with quotes"
+                        "description": "the components to update (defaults to all components). component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
                     }
                 ],
                 "examples": [
                     {
                         "cmd": "envs update",
-                        "description": "update all envs in the workspace to their latest version"
+                        "description": "update all envs for all components in the workspace, to their latest version"
                     },
                     {
                         "cmd": "envs update scope.org/env '**/ui/**'",
-                        "description": "update \"ui\" components that use scope.org/env to use its latest version"
+                        "description": "update components in the \"ui\" namespace that use scope.org/env to use its latest version"
                     },
                     {
                         "cmd": "envs update scope.org/env@2.0.0",
@@ -884,7 +884,7 @@
             [
                 "i",
                 "image <image>",
-                "image path. use one of the following extensions: [gif, png, svg, pdf]"
+                "image path and format. use one of the following extensions: [gif, png, svg, pdf]"
             ],
             [
                 "r",
@@ -907,7 +907,7 @@
                 "json format"
             ]
         ],
-        "description": "generate an image file with the dependencies graph",
+        "description": "generate an image file with the workspace components' dependencies graph",
         "extendedDescription": "",
         "group": "discover",
         "private": false,
@@ -930,7 +930,7 @@
             [
                 "r",
                 "rebuild",
-                "rebuild the UI"
+                "rebuild the UI (useful e.g. when updating the workspace UI - can use the dev flag for HMR in this case)"
             ],
             [
                 "",
@@ -990,17 +990,17 @@
             {
                 "name": "set <scope-name> [component-pattern]",
                 "options": [],
-                "description": "Sets components with a default-scope. If no component is specified, sets the workspace with a default scope",
-                "extendedDescription": "default scopes for components are set in the bitmap file. the default scope for a workspace is set in the workspace.jsonc. a component is set with a scope (as oppose to default scope) only once it is versioned.'\n\nyou can use a `<pattern>` for multiple component ids, such as `bit scope set scope-name \"org.scope/utils/**\"`.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.\n",
+                "description": "Sets the scope for specified component/s. If no component is specified, sets the default scope of the workspace",
+                "extendedDescription": "default scopes for components are set in the bitmap file. the default scope for a workspace is set in the workspace.jsonc.\na component is set with a scope (as oppose to default scope) only once it is versioned.'\n\nyou can use a `<pattern>` for multiple component ids, such as `bit scope set scope-name \"org.scope/utils/**\"`.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.\n",
                 "group": "development",
                 "arguments": [
                     {
                         "name": "scope-name",
-                        "description": "the scope name to use as the default scope"
+                        "description": "name of the scope to set"
                     },
                     {
                         "name": "component-pattern",
-                        "description": "component name, component id, or component pattern. use component pattern to select multiple components. \nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+                        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
                     }
                 ]
             },
@@ -1010,10 +1010,11 @@
                     [
                         "r",
                         "refactor",
-                        "update the import statements in all dependent components to the new package name (that contains the new scope name)"
+                        "update the import statements in all dependent components to the new package name (i.e. with the new scope name)"
                     ]
                 ],
-                "description": "Renames the scope name for all components with the specified 'current scope name'",
+                "description": "Renames the scope name for all components with the specified 'current scope name' - only available for new components that have not yet been snapped/tagged",
+                "extendedDescription": "Note: if `<current-scope-name>` is also the defaultScope for the workspace, this command will set `<new-scope-name>`\nas the defaultScope instead, and that will then be set for all components by default. You may see updates in your .bitmap file\nas a result of this change",
                 "group": "development",
                 "arguments": [
                     {
@@ -1051,7 +1052,7 @@
             {
                 "name": "fork <original-scope> <new-scope>",
                 "options": [],
-                "description": "fork all components of the original-scope and refactor the source-code to use the new package names",
+                "description": "fork all components of the original-scope and refactor the source-code to use the new scope name",
                 "group": "development"
             }
         ]
@@ -1063,7 +1064,7 @@
             [
                 "p",
                 "propagate",
-                "mark propagate true in the config file"
+                "mark propagate true in the config file, so that component.json configs will be merge with workspace configs"
             ],
             [
                 "o",
@@ -1072,7 +1073,7 @@
             ]
         ],
         "description": "eject components configuration (create a `component.json` file)",
-        "extendedDescription": "you can use a `<pattern>` for multiple component ids, such as `bit eject-conf \"org.scope/utils/**\"`.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.\n",
+        "extendedDescription": "note this can be reversed at any time by snapping/tagging changes and deleting the component.json file \nyou can use a `<pattern>` for multiple component ids, such as `bit eject-conf \"org.scope/utils/**\"`.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.\n",
         "group": "development",
         "private": false
     },
@@ -1210,7 +1211,7 @@
             ]
         ],
         "description": "list the component ids matching the given pattern",
-        "extendedDescription": "this command helps validating a pattern before using it in other commands.\na pattern can be a simple component-id or component-name. e.g. \"ui/button\".\na pattern can be used with wildcards for multiple component ids, e.g. \"org.scope/utils/**\".\nto enter multiple patterns, separate them by a comma, e.g. \"ui/*, lib/*\"\nto exclude, use \"!\". e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nthe matching algorithm is done by multimatch (@see https://github.com/sindresorhus/multimatch)\n",
+        "extendedDescription": "this command helps validating a pattern before using it in other commands.\na pattern can be a simple component-id or component-name. e.g. \"ui/button\".\na pattern can be used with wildcards for multiple component ids, e.g. \"org.scope/utils/**\" or \"**/utils/**\" to capture all org/scopes.\nto enter multiple patterns, separate them by a comma, e.g. \"ui/*, lib/*\"\nto exclude, use \"!\". e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nthe matching algorithm is from multimatch (@see https://github.com/sindresorhus/multimatch)\n",
         "group": "development",
         "private": false,
         "examples": [
@@ -1224,7 +1225,7 @@
             },
             {
                 "cmd": "bit pattern \"*/ui/**\"",
-                "description": "matches components that their namespace starts with \"ui/\" e.g. \"ui/button\", \"ui/elements/button\""
+                "description": "matches components whose namespace starts with \"ui/\" e.g. \"ui/button\", \"ui/elements/button\""
             },
             {
                 "cmd": "bit pattern \"bar, foo\"",
@@ -1278,12 +1279,12 @@
             [
                 "v",
                 "verbose",
-                "show npm verbose output for inspection and print the stack trace"
+                "show all watch events and compiler verbose output"
             ],
             [
                 "",
                 "skip-pre-compilation",
-                "skip the compilation step before starting to watch"
+                "skip compilation step before starting to watch"
             ],
             [
                 "t",
@@ -1292,7 +1293,7 @@
             ]
         ],
         "description": "automatically recompile modified components (on save)",
-        "extendedDescription": "",
+        "extendedDescription": "by default, the watcher doesn't use polling, to keep the CPU idle.\nin some rare cases, this could result in missing file events. to fix it, try to prefix this command with CHOKIDAR_USEPOLLING=true\nalternatively, restarting the computer could also help.",
         "group": "development",
         "private": false
     },
@@ -1308,7 +1309,7 @@
             [
                 "m",
                 "main <file>",
-                "define entry point for the components"
+                "define component entry point"
             ],
             [
                 "n",
@@ -1323,7 +1324,7 @@
             [
                 "s",
                 "scope <string>",
-                "sets the component's scope-name. if not entered, the default-scope will be used"
+                "sets the component's scope. if not entered, the default-scope from workspace.jsonc will be used"
             ],
             [
                 "e",
@@ -1424,7 +1425,7 @@
                 "show templates provided by the aspect-id"
             ]
         ],
-        "description": "list templates for \"bit create\" and \"bit new\"",
+        "description": "list available templates for \"bit create\" and \"bit new\"",
         "extendedDescription": "list components templates when inside bit-workspace (for bit-create), otherwise, list workspace templates (for bit-new)",
         "group": "development",
         "private": false
@@ -1436,22 +1437,22 @@
             [
                 "a",
                 "aspect <aspect-id>",
-                "aspect-id of the template. mandatory for non-core aspects. helpful for core aspects in case of a name collision"
+                "id of the aspect that registered the template, mandatory for non-core aspects. helpful for core aspects in case of a name collision"
             ],
             [
                 "t",
                 "template <env-id>",
-                "env-id of the template. alias for --env."
+                "env-id of the template's owner. Alias for --env."
             ],
             [
                 "",
                 "env <env-id>",
-                "env-id of the template"
+                "env-id of the template. Alias -t"
             ],
             [
                 "d",
                 "default-scope <scope-name>",
-                "set defaultScope in the new workspace.jsonc"
+                "set defaultScope in the new workspace's workspace.jsonc"
             ],
             [
                 "",
@@ -1461,17 +1462,17 @@
             [
                 "s",
                 "skip-git",
-                "skip generation of Git repository"
+                "skip generation of Git repository in the new workspace"
             ],
             [
                 "e",
                 "empty",
-                "empty workspace with no components (relevant for templates that add components by default)"
+                "skip template's default component creation (relevant for templates that add components by default)"
             ],
             [
                 "",
                 "load-from <path-to-template>",
-                "path to the workspace containing the template. helpful during a development of a workspace-template"
+                "local path to the workspace containing the template. Helpful during a development of a workspace-template"
             ]
         ],
         "description": "create a new workspace from a template",
@@ -1481,11 +1482,11 @@
         "arguments": [
             {
                 "name": "template-name",
-                "description": "the name of the workspace template (run 'bit templates', outside of a workspace, to get a list of available templates)"
+                "description": "the name of the workspace template (run 'bit templates' outside of a workspace to get a list of available workspace templates)"
             },
             {
                 "name": "workspace-name",
-                "description": "the name for the new workspace and workspace directory"
+                "description": "the name for the new workspace and workspace directory that will be created"
             }
         ]
     },
@@ -1536,16 +1537,16 @@
             [
                 "",
                 "skip-tests",
-                "skip running component tests during tag process"
+                "skip running component tests during build process"
             ],
             [
                 "",
                 "fail-fast",
-                "stop pipeline execution on the first failed task (by default a task is skipped only when its dependent failed)"
+                "stop pipeline execution on the first failed task (by default a task is skipped only when its dependency failed)"
             ]
         ],
-        "description": "run set of tasks for build",
-        "extendedDescription": "",
+        "description": "run set of tasks for build. ",
+        "extendedDescription": "by default, only new and modified components are built",
         "group": "development",
         "private": false,
         "arguments": [
@@ -1580,7 +1581,7 @@
                 "download the files to the specified dir"
             ]
         ],
-        "description": "list and download components artifacts",
+        "description": "list and download component artifacts",
         "extendedDescription": "artifacts are created on isolated capsules during tag or snap commands.\nexample of artifacts are dists files generated by a compiler, a JUnit.xml file generated by a tester\nand a package.tgz file generated by pkg aspect.\n",
         "group": "development",
         "private": false,
@@ -1603,12 +1604,12 @@
             [
                 "p",
                 "port [port-number]",
-                "port of the app"
+                "port to run the app on"
             ],
             [
                 "v",
                 "verbose",
-                "showing verbose output for inspection and prints stack trace"
+                "show verbose output for inspection and print stack trace"
             ],
             [
                 "",
@@ -1621,7 +1622,7 @@
                 "run app in server side rendering mode."
             ]
         ],
-        "description": "run an app (independent of bit's dev server)",
+        "description": "locally run an app component (independent of bit's dev server)",
         "extendedDescription": "",
         "group": "apps",
         "private": false,
@@ -1683,12 +1684,12 @@
                     [
                         "p",
                         "port [port-number]",
-                        "port of the app"
+                        "port to run the app on"
                     ],
                     [
                         "v",
                         "verbose",
-                        "showing verbose output for inspection and prints stack trace"
+                        "show verbose output for inspection and print stack trace"
                     ],
                     [
                         "",
@@ -1701,7 +1702,7 @@
                         "run app in server side rendering mode."
                     ]
                 ],
-                "description": "run an app (independent of bit's dev server)",
+                "description": "locally run an app component (independent of bit's dev server)",
                 "extendedDescription": "",
                 "group": "apps",
                 "private": false,
@@ -1762,7 +1763,7 @@
             [
                 "u",
                 "update",
-                "update all dependencies"
+                "update all dependencies to latest version according to their semver range"
             ],
             [
                 "",
@@ -1837,7 +1838,7 @@
             [
                 "y",
                 "yes",
-                "automatically update all outdated packages"
+                "automatically update all outdated versions for packages specified in pattern (all if no pattern supplied) - use carefully as could result in breaking updates for dependencies"
             ],
             [
                 "",
@@ -1862,7 +1863,7 @@
         "arguments": [
             {
                 "name": "package-patterns...",
-                "description": "a list of package names, or patterns (separated by space). The patterns should be in glob format. By default, all packages are selected."
+                "description": "a string list of package names, or patterns (separated by space), e.g. \"@teambit/** @my-org/ui/**\". The patterns should be in glob format. By default, all packages are selected."
             }
         ]
     },
@@ -1911,18 +1912,18 @@
         "name": "move <current-component-dir> <new-component-dir>",
         "alias": "mv",
         "options": [],
-        "description": "move a component to a different filesystem path",
-        "extendedDescription": "move files or directories of component(s)\n  https://bit.dev/docs/workspace/moving-components",
+        "description": "move a component to a different filesystem path (note: this does NOT affect the component's name or scope, just its location in the workspace)",
+        "extendedDescription": "move files or directories of component(s)\n",
         "group": "development",
         "private": false,
         "arguments": [
             {
                 "name": "current-component-dir",
-                "description": "the current relative path (in the workspace) to the component directory"
+                "description": "the component's current directory (relative to the workspace root)"
             },
             {
                 "name": "new-component-dir",
-                "description": "the new relative path (in the workspace) to the component directory"
+                "description": "the new directory (relative to the workspace root) to create and move the component's files to"
             }
         ]
     },
@@ -1938,12 +1939,7 @@
             [
                 "o",
                 "objects",
-                "import components objects to the local scope without checkout (without writing them to the file system). This is a default behavior for import with no id argument"
-            ],
-            [
-                "d",
-                "display-dependencies",
-                "display the imported dependencies"
+                "import components objects to the local scope without checkout (without writing them to the file system). This is the default behavior for import with no id argument"
             ],
             [
                 "O",
@@ -1963,7 +1959,7 @@
             [
                 "x",
                 "skip-dependency-installation",
-                "do not install packages of the imported components"
+                "do not auto-install dependencies of the imported components"
             ],
             [
                 "m",
@@ -1973,17 +1969,17 @@
             [
                 "",
                 "dependencies",
-                "import all dependencies and write them to the workspace"
+                "import all dependencies (bit components only) of imported components and write them to the workspace"
             ],
             [
                 "",
                 "dependents",
-                "import components found while traversing from the given ids upwards to the workspace components"
+                "import components found while traversing from the imported components upwards to the workspace components"
             ],
             [
                 "",
                 "save-in-lane",
-                "when checked out to a lane and the component is not on the remote-lane, save it in the lane (default to save on main)"
+                "when checked out to a lane and the component is not on the remote-lane, save it in the lane (defaults to save on main)"
             ],
             [
                 "",
@@ -1993,12 +1989,12 @@
             [
                 "",
                 "fetch-deps",
-                "fetch dependencies objects"
+                "fetch dependencies (bit components) objects to the local scope, but dont add to the workspace. Useful to resolve errors about missing dependency data"
             ],
             [
                 "",
                 "track-only",
-                "do not write any file, just create .bitmap entries of the imported components"
+                "do not write any component files, just create .bitmap entries of the imported components. Useful when the files already exist and just want to re-add the component to the bitmap"
             ],
             [
                 "",
@@ -2035,7 +2031,7 @@
             [
                 "",
                 "all-history",
-                "for each one of the component, fetch all its versions. by default, only the latest version is fetched"
+                "for each component, fetch all its versions. by default, only the latest version is fetched"
             ],
             [
                 "j",
@@ -2088,8 +2084,8 @@
                 "skip confirmation"
             ]
         ],
-        "description": "remove component(s) from the workspace, or a remote scope",
-        "extendedDescription": "to remove components from your local workspace only, use \"bit remove\" (with no flags).\n\nto remove a component from the remote scope, use \"bit remove --delete\", to mark the components as deleted.\nonce tagged/snapped and exported, the remote scope will be updated and it'll be marked as deleted there as well.\n\nto remove components from lanes, use \"bit lane remove-comp\".\n",
+        "description": "remove component(s) from the workspace, or a remote scope (with a flag)",
+        "extendedDescription": "to remove components from your local workspace only, use \"bit remove\" (with no flags).\n\nto remove a component from the remote scope, use \"bit remove --delete\", to mark the components as deleted.\nonce tagged/snapped and exported, the remote scope will be updated and it'll be marked as deleted there as well.\n\nto remove components from a lane, use \"bit lane remove-comp\".\n",
         "group": "collaborate",
         "private": false,
         "remoteOp": true,
@@ -2111,7 +2107,7 @@
                 "do not install packages in case of importing components"
             ]
         ],
-        "description": "EXPERIMENTAL. recover soft-removed component(s) from the workspace, or a remote scope",
+        "description": "EXPERIMENTAL. recover component(s) soft-deleted from the workspace, or a remote scope",
         "extendedDescription": "",
         "group": "collaborate",
         "private": false
@@ -2121,7 +2117,7 @@
         "alias": "",
         "options": [],
         "description": "EXPERIMENTAL. resume failed export",
-        "extendedDescription": "resume failed export to persist the pending objects on the given remotes.\nthe export-id is the id the client got in the error message during the failure.\nalternatively, exporting to any one of the failed scopes, throws server-is-busy error with the export-id",
+        "extendedDescription": "resume failed export to persist the pending objects on the given remotes.\nthe export-id is the id the client received in the error message during the failure.\nalternatively, exporting to any one of the failed scopes, throws server-is-busy error with the export-id",
         "group": "collaborate",
         "private": true,
         "remoteOp": true
@@ -2133,7 +2129,7 @@
             [
                 "e",
                 "eject",
-                "replace the exported components with their corresponding packages (to use these components without further maintaining them)"
+                "remove component from the workspace and install it instead as a regular npm package"
             ],
             [
                 "a",
@@ -2172,14 +2168,14 @@
             ]
         ],
         "description": "export components from the workspace to remote scopes",
-        "extendedDescription": "bit export => export all staged components to their current scope, if checked out to a lane, export the lane as well\n  `bit export [id...]` => export the given ids to their current scope\n  you can use a pattern for multiple ids, such as bit export remote-scope \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
+        "extendedDescription": "bit export => export all staged snaps/tags of components to their remote scope. if checked out to a lane, export the lane as well\n  `bit export [pattern...]` => export components included by the pattern to their remote scope (we recommend not using a pattern in\n    most scenarios so that all changes are exported simultaneously)\n  you can use a pattern for multiple ids, such as bit export \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
         "group": "collaborate",
         "private": false,
         "remoteOp": true,
         "arguments": [
             {
                 "name": "component-patterns...",
-                "description": "component IDs, component names, or component patterns (separated by space). Use patterns to export groups of components using a common scope or namespace. E.g., \"utils/*\" (wrap with double quotes)"
+                "description": "(not recommended) component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
             }
         ]
     },
@@ -2265,7 +2261,7 @@
             [
                 "",
                 "snapped",
-                "tag components that their head is a snap (not a tag)"
+                "tag only components whose head is a snap (not a tag)"
             ],
             [
                 "",
@@ -2305,7 +2301,7 @@
             [
                 "",
                 "ignore-build-errors",
-                "run the tag pipeline although the build pipeline failed"
+                "proceed to tag pipeline even when build pipeline fails"
             ],
             [
                 "",
@@ -2320,12 +2316,12 @@
             [
                 "I",
                 "ignore-newest-version",
-                "ignore existing of newer versions (default = false)"
+                "allow tagging even when the component has newer versions e.g. for hotfixes (default = false)"
             ],
             [
                 "",
                 "fail-fast",
-                "stop pipeline execution on the first failed task (by default a task is skipped only when its dependent failed)"
+                "stop pipeline execution on the first failed task (by default a task is skipped only when its dependency failed)"
             ],
             [
                 "b",
@@ -2340,12 +2336,12 @@
             [
                 "s",
                 "scope [version]",
-                "DEPRECATED (use \"--unmodified\" instead). tag all components of the current scope"
+                "DEPRECATED (use \"--unmodified\" instead). tag all components of the local scope"
             ],
             [
                 "f",
                 "force",
-                "DEPRECATED (use \"--skip-tests\" or \"--unmodified\" instead). force-tag even if tests are failing and even when component has not changed"
+                "DEPRECATED (use \"--skip-tests\", \"--ignore-build-errors\" or \"--unmodified\" instead). force-tag even if tests are failing and even when component has not changed"
             ],
             [
                 "",
@@ -2361,7 +2357,7 @@
         "arguments": [
             {
                 "name": "component-patterns...",
-                "description": "a list of component names, IDs or patterns (separated by space). run \"bit pattern --help\" to get more data about patterns. By default, all modified are tagged."
+                "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes. By default, all new and modified are tagged."
             }
         ],
         "examples": [
@@ -2378,7 +2374,7 @@
             [
                 "m",
                 "message <message>",
-                "log message describing the latest changes"
+                "snap message describing the latest changes - will appear in component history log"
             ],
             [
                 "",
@@ -2393,12 +2389,12 @@
             [
                 "b",
                 "build",
-                "not needed for now. run the build pipeline in case the feature-flag build-on-ci is enabled"
+                "not needed for now. run the build pipeline locally in case the feature-flag build-on-ci is enabled"
             ],
             [
                 "",
                 "editor [editor]",
-                "open an editor to write a tag message for each component. optionally, specify the editor-name (defaults to vim)."
+                "open an editor to write a snap message per component. optionally specify the editor-name (defaults to vim)."
             ],
             [
                 "",
@@ -2413,7 +2409,7 @@
             [
                 "",
                 "disable-snap-pipeline",
-                "skip the snap pipeline"
+                "skip the snap pipeline. this will for instance skip packing and publishing component version for install, and app deployment"
             ],
             [
                 "",
@@ -2423,7 +2419,7 @@
             [
                 "",
                 "ignore-build-errors",
-                "run the snap pipeline although the build pipeline failed"
+                "proceed to snap pipeline even when build pipeline fails"
             ],
             [
                 "i",
@@ -2433,12 +2429,12 @@
             [
                 "a",
                 "all",
-                "DEPRECATED (not needed anymore, it is the default now). snap all new and modified components"
+                "DEPRECATED (not needed anymore, now the default). snap all new and modified components"
             ],
             [
                 "",
                 "fail-fast",
-                "stop pipeline execution on the first failed task (by default a task is skipped only when its dependent failed)"
+                "stop pipeline execution on the first failed task (by default a task is skipped only when its dependency failed)"
             ],
             [
                 "f",
@@ -2446,14 +2442,14 @@
                 "DEPRECATED (use \"--skip-tests\" or \"--unmodified\" instead). force-snap even if tests are failing and even when component has not changed"
             ]
         ],
-        "description": "create an immutable and exportable component snapshot (no release version)",
+        "description": "create an immutable and exportable component snapshot (non-release version)",
         "extendedDescription": "",
         "group": "development",
         "private": false,
         "arguments": [
             {
                 "name": "component-pattern",
-                "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes. By default, all new and modified components are snapped."
+                "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes. By default, only new and modified components are snapped (add --unmodified to snap all components in the workspace)."
             }
         ]
     },
@@ -2464,7 +2460,7 @@
             [
                 "a",
                 "all",
-                "revert tag/snap for all tagged/snapped components"
+                "revert all unexported tags/snaps for all components"
             ],
             [
                 "",
@@ -2479,7 +2475,7 @@
             [
                 "f",
                 "force",
-                "revert the tag even if used as a dependency. WARNING: components that depend on this tag will corrupt"
+                "revert the tag even if it's used as a dependency. WARNING: components that depend on this tag will be corrupted"
             ]
         ],
         "description": "revert tagged or snapped versions for component(s)",
@@ -2675,7 +2671,7 @@
             [
                 "",
                 "auto-merge-resolve <merge-strategy>",
-                "in case of a conflict, resolve according to the strategy: [ours, theirs, manual]"
+                "in case of merge conflict, resolve according to the provided strategy: [ours, theirs, manual]"
             ],
             [
                 "r",
@@ -2690,7 +2686,7 @@
             [
                 "e",
                 "workspace-only",
-                "when on a lane, avoid introducing new components from the remote lane that do not exist locally"
+                "only relevant for 'bit checkout head' when on a lane. don't import components from the remote lane that are not already in the workspace"
             ],
             [
                 "v",
@@ -2700,11 +2696,11 @@
             [
                 "x",
                 "skip-dependency-installation",
-                "do not install packages of the imported components"
+                "do not auto-install dependencies of the imported components"
             ]
         ],
         "description": "switch between component versions or remove local changes",
-        "extendedDescription": "\n  `bit checkout <version> [component-pattern]` => checkout the specified ids (or all components when --all is used) to the specified version\n  `bit checkout head [component-pattern]` => checkout to the last snap/tag, omit [component-pattern] to checkout head for all\n  `bit checkout latest [component-pattern]` => checkout to the latest satisfying semver tag, omit [component-pattern] to checkout latest for all\n  `bit checkout reset [component-pattern]` => remove local modifications from the specified ids (or all components when --all is used)",
+        "extendedDescription": "\n  `bit checkout <version> [component-pattern]` => checkout the specified ids (or all components when --all is used) to the specified version\n  `bit checkout head [component-pattern]` => checkout to the last snap/tag (use --latest if you only want semver tags), omit [component-pattern] to checkout head for all\n  `bit checkout latest [component-pattern]` => checkout to the latest satisfying semver tag, omit [component-pattern] to checkout latest for all\n  `bit checkout reset [component-pattern]` => remove local modifications from the specified ids (or all components when --all is used)",
         "group": "development",
         "private": false,
         "arguments": [
@@ -2831,7 +2827,7 @@
             [
                 "e",
                 "env <id>",
-                "test only the given env"
+                "test only components assigned the given env"
             ],
             [
                 "s",
@@ -2839,7 +2835,7 @@
                 "DEPRECATED. (use the pattern instead, e.g. \"scopeName/**\"). name of the scope to test"
             ]
         ],
-        "description": "test components in the workspace",
+        "description": "test components in the workspace. by default only runs tests for new and modified components",
         "extendedDescription": "",
         "group": "development",
         "private": false,
@@ -2857,7 +2853,7 @@
             [
                 "v",
                 "verbose",
-                "show a more verbose output when possible"
+                "show a more verbose output where possible"
             ],
             [
                 "t",
@@ -2865,8 +2861,8 @@
                 "show tables instead of plain text for dependencies diff"
             ]
         ],
-        "description": "show the diff between the components' source files and config",
-        "extendedDescription": "bit diff => compare all modified components to their model version\nbit diff [ids...] => compare the specified components against their modified states\nbit diff [id] [version] => compare the specified version to used or modified files\nbit diff [id] [version] [to_version] => compare the specified version files to to_version files\nyou can use a pattern for multiple ids, such as bit diff \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
+        "description": "show the diff between the components' current source files and config, and their latest snapshot or tag",
+        "extendedDescription": "bit diff => compare all modified components to their model version\nbit diff [ids...] => compare the specified components against their modified states\nbit diff [id] [version] => compare component's current files and configs to the specified version of the component\nbit diff [id] [version] [to_version] => compare component's files and configs between the specified version and the to_version provided\nyou can use a pattern for multiple ids, such as bit diff \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
         "group": "development",
         "private": false
     },
@@ -2877,12 +2873,12 @@
             [
                 "",
                 "ours",
-                "DEPRECATED. use --auto-merge-resolve. In the future, this flag will leave the current code intact"
+                "DEPRECATED. use --auto-merge-resolve. in case of a conflict, keep the local modification"
             ],
             [
                 "",
                 "theirs",
-                "DEPRECATED. use --auto-merge-resolve. In the future, this flag will override the current code with the incoming code"
+                "DEPRECATED. use --auto-merge-resolve. in case of a conflict, override the local modification with the specified version"
             ],
             [
                 "",
@@ -2897,7 +2893,7 @@
             [
                 "",
                 "abort",
-                "in case of an unresolved merge, revert to the state before the merge began"
+                "in case of an unresolved merge, revert to pre-merge state"
             ],
             [
                 "",
@@ -2907,7 +2903,7 @@
             [
                 "",
                 "no-snap",
-                "do not auto snap in case the merge completed without conflicts"
+                "do not auto snap even if the merge completed without conflicts"
             ],
             [
                 "",
@@ -2917,12 +2913,12 @@
             [
                 "",
                 "verbose",
-                "show details of components that were not merged legitimately"
+                "show details of components that were not merged successfully"
             ],
             [
                 "x",
                 "skip-dependency-installation",
-                "do not install packages of the imported components"
+                "do not install new dependencies resulting from the merge"
             ],
             [
                 "m",
@@ -2930,13 +2926,13 @@
                 "override the default message for the auto snap"
             ]
         ],
-        "description": "merge changes of the remote head into local",
-        "extendedDescription": "merge changes of the remote head into local. when on a lane, merge the remote head of the lane into the local.\nif no ids are specified, all pending-merge components will be merged. (run \"bit status\" to list them).\noptionally use '--abort' to revert the last merge. to revert a lane merge, use \"bit lane merge-abort\" command.\nyou can use a pattern for multiple ids, such as bit merge \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
+        "description": "merge changes of the remote head into local - auto-snaps all merged components",
+        "extendedDescription": "merge changes of the remote head into local when they are diverged. when on a lane, merge the remote head of the lane into the local\nand creates snaps for merged components that have diverged, on the lane.\nif no ids are specified, all pending-merge components will be merged. (run \"bit status\" to list them).\noptionally use '--abort' to revert the last merge. to revert a lane merge, use \"bit lane merge-abort\" command.\nyou can use a pattern for multiple ids, such as bit merge \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
         "group": "development",
         "private": false
     },
     {
-        "name": "lane [lane-name]",
+        "name": "lane [sub-command]",
         "alias": "l",
         "options": [
             [
@@ -2951,21 +2947,21 @@
             ],
             [
                 "r",
-                "remote <string>",
-                "show remote lanes"
+                "remote <remote-scope-name>",
+                "show all remote lanes from the specified scope"
             ],
             [
                 "",
                 "merged",
-                "show merged lanes"
+                "list only merged lanes"
             ],
             [
                 "",
                 "not-merged",
-                "show not merged lanes"
+                "list only lanes that haven't been merged"
             ]
         ],
-        "description": "manage lanes",
+        "description": "manage lanes - if no sub-command is used, runs \"bit lane list\"",
         "extendedDescription": "",
         "group": "collaborate",
         "private": false,
@@ -2984,25 +2980,25 @@
                     [
                         "j",
                         "json",
-                        "show lanes details in a json format"
+                        "show lanes' details in a json format"
                     ],
                     [
                         "r",
                         "remote <remote-scope-name>",
-                        "show remote lanes"
+                        "show all remote lanes from the specified scope"
                     ],
                     [
                         "",
                         "merged",
-                        "show merged lanes"
+                        "list only merged lanes"
                     ],
                     [
                         "",
                         "not-merged",
-                        "show lanes that are not merged"
+                        "list only lanes that haven't been merged"
                     ]
                 ],
-                "description": "list lanes",
+                "description": "list local lanes",
                 "extendedDescription": "",
                 "group": "ungrouped",
                 "private": false,
@@ -3010,13 +3006,13 @@
                 "skipWorkspace": true
             },
             {
-                "name": "switch <lane> [pattern]",
+                "name": "switch <lane>",
                 "alias": "",
                 "options": [
                     [
                         "n",
                         "alias <string>",
-                        "relevant when the specified lane is a remote late. name a local lane differently than the remote lane"
+                        "relevant when the specified lane is a remote lane. create a local alias for the lane (doesnt affect the lane's name on the remote"
                     ],
                     [
                         "m",
@@ -3026,17 +3022,17 @@
                     [
                         "a",
                         "get-all",
-                        "checkout all components in a lane include ones that do not exist in the workspace"
+                        "checkout all components in a lane, including those not currently in the workspace"
                     ],
                     [
                         "x",
                         "skip-dependency-installation",
-                        "do not install packages of the imported components"
+                        "do not install dependencies of the imported components"
                     ],
                     [
                         "p",
                         "pattern <component-pattern>",
-                        "switch only the specified component-pattern. works only when the workspace is empty"
+                        "switch only the lane components matching the specified component-pattern. only works when the workspace is empty\n\ncomponent name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
                     ],
                     [
                         "j",
@@ -3051,7 +3047,7 @@
                 "arguments": [
                     {
                         "name": "lane",
-                        "description": "lane-name or lane-id (if not exists locally) to switch to"
+                        "description": "lane-name or lane-id (if lane is not local) to switch to"
                     }
                 ]
             },
@@ -3067,7 +3063,7 @@
                     [
                         "r",
                         "remote",
-                        "show the lane from remote"
+                        "show details of the remote head of the provided lane"
                     ]
                 ],
                 "description": "show lane details. if no lane specified, show the current lane",
@@ -3084,7 +3080,7 @@
                     [
                         "s",
                         "scope <scope-name>",
-                        "remote scope where this lane will be exported to, default to the defaultScope (can be changed later with \"bit lane change-scope\")"
+                        "remote scope to which this lane will be exported, default to the workspace.json's defaultScope (can be changed up to first export of the lane with \"bit lane change-scope\")"
                     ],
                     [
                         "",
@@ -3099,11 +3095,11 @@
                     [
                         "",
                         "fork-lane-new-scope",
-                        "allow forking a lane into a different scope than the original lane"
+                        "create the new lane in a different scope than its parent lane (if created from another lane)"
                     ]
                 ],
                 "description": "creates a new lane and switches to it",
-                "extendedDescription": "a lane created from main (default-lane) is empty until components are snapped.\na lane created from another lane has all the components of the original lane.",
+                "extendedDescription": "a lane created from main (default-lane) is empty until components are snapped.\na lane created from another lane contains all the components of the original lane.",
                 "group": "ungrouped",
                 "private": false,
                 "arguments": [
@@ -3120,12 +3116,12 @@
                     [
                         "r",
                         "remote",
-                        "remove a remote lane (in the lane arg, use remote/lane-id syntax)"
+                        "delete a remote lane. use remote/lane-id syntax e.g. bit lane remove owner.org/my-lane --remote. Delete is immediate, no export required"
                     ],
                     [
                         "f",
                         "force",
-                        "removes the lane even when the lane was not merged yet"
+                        "removes/deletes the lane even when the lane is not yet merged to main"
                     ],
                     [
                         "s",
@@ -3133,7 +3129,7 @@
                         "skip confirmation"
                     ]
                 ],
-                "description": "remove lanes",
+                "description": "remove or delete lanes",
                 "extendedDescription": "",
                 "group": "collaborate",
                 "private": false,
@@ -3149,7 +3145,7 @@
                 "alias": "",
                 "options": [],
                 "description": "changes the remote scope of a lane",
-                "extendedDescription": "",
+                "extendedDescription": "NOTE: available only before the lane is exported to the remote",
                 "group": "ungrouped",
                 "private": false
             },
@@ -3158,7 +3154,7 @@
                 "alias": "",
                 "options": [],
                 "description": "adds an alias to a lane",
-                "extendedDescription": "an alias is a name that can be used to refer to a lane. it is saved locally and never reach the remote.\nit is useful when having multiple lanes with the same name, but with different remote scopes.",
+                "extendedDescription": "an alias is a name that can be used locally to refer to a lane. it is saved locally and never reaches the remote.\nit is useful e.g. when having multiple lanes with the same name, but with different remote scopes.",
                 "group": "ungrouped",
                 "private": false
             },
@@ -3178,7 +3174,7 @@
                     [
                         "",
                         "pattern <component-pattern>",
-                        "show lane-diff for the specified component-pattern only"
+                        "show lane-diff for components conforming to the specified component-pattern only\ncomponent-pattern format: component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
                     ]
                 ],
                 "description": "show diff between lanes",
@@ -3186,13 +3182,23 @@
                 "group": "ungrouped",
                 "private": true,
                 "remoteOp": true,
-                "skipWorkspace": true
+                "skipWorkspace": true,
+                "arguments": [
+                    {
+                        "name": "from",
+                        "description": "base lane for comparison"
+                    },
+                    {
+                        "name": "to",
+                        "description": "lane being compared to base lane"
+                    }
+                ]
             },
             {
                 "name": "add-readme <component-name> [lane-name]",
                 "alias": "",
                 "options": [],
-                "description": "EXPERIMENTAL. adds a readme component to a lane",
+                "description": "EXPERIMENTAL. sets an existing component as the readme of a lane",
                 "extendedDescription": "",
                 "group": "ungrouped",
                 "private": false,
@@ -3225,15 +3231,15 @@
                     [
                         "x",
                         "skip-dependency-installation",
-                        "do not install packages of the imported components"
+                        "do not install dependencies of the imported components"
                     ],
                     [
                         "p",
                         "pattern <component-pattern>",
-                        "switch only the specified component-pattern. works only when the workspace is empty"
+                        "import only components from the lane that fit the specified component-pattern to the workspace. works only when the workspace is empty"
                     ]
                 ],
-                "description": "import a remote lane to your workspace",
+                "description": "import a remote lane to your workspace and switch to that lane",
                 "extendedDescription": "",
                 "group": "ungrouped",
                 "private": false,
@@ -3251,16 +3257,16 @@
                     [
                         "",
                         "workspace-only",
-                        "do not mark the components as removed. instead, remove them from the workspace only"
+                        "do not mark the components as removed from the lane. instead, remove them from the workspace only"
                     ],
                     [
                         "",
                         "update-main",
-                        "EXPERIMENTAL. mark as removed on main after merging this lane into main"
+                        "EXPERIMENTAL. remove, i.e. delete, component/s on the main lane after merging this lane into main"
                     ]
                 ],
                 "description": "remove components when on a lane",
-                "extendedDescription": "in case the components are part of the lane and the lane is exported, it marks the components as removed,\nand then after snap+export, the remote-lane gets updated as well. upon lane-merge, these components are skipped.\n\nin case the components are not part of the lane or the lane is new, it simply removes the components from the workspace",
+                "extendedDescription": "in case the components are part of the lane and the lane is exported, it marks the components as\nremoved from the lane, and then after snap+export, the remote-lane gets updated as well.\nupon lane-merge, these removed components are skipped and any changes for removed components won't be merged to main.\n\nin case the components are not yet part of the lane or the lane is new, it simply removes the components from the workspace",
                 "group": "collaborate",
                 "private": false,
                 "arguments": [
@@ -3277,12 +3283,12 @@
                     [
                         "",
                         "ours",
-                        "DEPRECATED. use --auto-merge-resolve. In the future, this flag will leave the current code intact"
+                        "DEPRECATED. use --auto-merge-resolve. in case of a conflict, keep local modifications"
                     ],
                     [
                         "",
                         "theirs",
-                        "DEPRECATED. use --auto-merge-resolve. In the future, this flag will override the current code with the incoming code"
+                        "DEPRECATED. use --auto-merge-resolve. in case of a conflict, override local with incoming changes"
                     ],
                     [
                         "",
@@ -3292,22 +3298,22 @@
                     [
                         "",
                         "auto-merge-resolve <merge-strategy>",
-                        "in case of a conflict, resolve according to the strategy: [ours, theirs, manual]"
+                        "in case of a merge conflict, resolve according to the provided strategy: [ours, theirs, manual]"
                     ],
                     [
                         "",
                         "workspace",
-                        "merge only components in a lane that exist in the workspace"
+                        "merge only lane components that are in the current workspace"
                     ],
                     [
                         "",
                         "no-snap",
-                        "do not auto snap in case the merge completed without conflicts"
+                        "do not auto snap after merge completed without conflicts"
                     ],
                     [
                         "",
                         "tag",
-                        "tag all lane components after merging into main (also tag-merge in case of snap-merge)"
+                        "auto-tag all lane components after merging into main (or tag-merge in case of snap-merge)"
                     ],
                     [
                         "",
@@ -3327,42 +3333,42 @@
                     [
                         "",
                         "no-squash",
-                        "relevant for merging lanes into main, which by default squash"
+                        "relevant for merging lanes into main, which by default squashes all lane snaps"
                     ],
                     [
                         "",
                         "squash",
-                        "EXPERIMENTAL. relevant for merging a lane into another lane, which by default does not squash"
+                        "EXPERIMENTAL. relevant for merging a lane into another non-main lane, which by default does not squash"
                     ],
                     [
                         "",
                         "ignore-config-changes",
-                        "allow merging when component are modified due to config changes (such as dependencies) only and not files"
+                        "allow merging when components are modified due to config changes (such as dependencies) only and not files"
                     ],
                     [
                         "",
                         "verbose",
-                        "show details of components that were not merged legitimately"
+                        "show details of components that were not merged successfully"
                     ],
                     [
                         "x",
                         "skip-dependency-installation",
-                        "do not install packages of the imported components"
+                        "do not install dependencies of the imported components"
                     ],
                     [
                         "",
                         "skip-fetch",
-                        "use the current target-lane if exits locally without updating it from the remote"
+                        "use the local state of target-lane if exits locally, without updating it from the remote"
                     ],
                     [
                         "",
                         "include-deps",
-                        "relevant for \"--pattern\" and \"--workspace\". merge also dependencies of the given components"
+                        "relevant for \"--pattern\" and \"--workspace\". merge also dependencies of the specified components"
                     ],
                     [
                         "",
                         "resolve-unrelated [merge-strategy]",
-                        "relevant when a component on a lane and the component on main has nothing in common. merge-strategy can be \"ours\" (default) or \"theirs\""
+                        "relevant when a component on a lane and the component on main have nothing in common. merge-strategy can be \"ours\" (default) or \"theirs\""
                     ],
                     [
                         "",
@@ -3370,18 +3376,18 @@
                         "when merging main, include workspace components that are not on the lane (by default only lane components are merged)"
                     ]
                 ],
-                "description": "merge a local or a remote lane",
-                "extendedDescription": "by default, the provided lane will be fetched from the remote before merging.\nto merge the lane from the local scope without updating it first, use \"--skip-fetch\" flag.\n\nwhen the current and the other lanes are diverged in history and the files could be merged with no conflicts,\nit will snap-merge these components to complete the merge. use \"no-snap\" to opt-out, or \"tag\" to tag instead",
+                "description": "merge a local or a remote lane to the current lane",
+                "extendedDescription": "by default, the provided lane will be fetched from the remote before merging.\nto merge the lane from the local scope without updating it first, use \"--skip-fetch\" flag.\n\nwhen the current and merge candidate lanes are diverged in history and the files could be merged with no conflicts,\nthese components will be snap-merged to complete the merge. use \"no-snap\" to opt-out, or \"tag\" to tag instead",
                 "private": true,
                 "remoteOp": true,
                 "arguments": [
                     {
                         "name": "lane",
-                        "description": "lane-name or lane-id (if not exists locally) to merge to the current lane"
+                        "description": "lane-name or full lane-id (if remote) to merge to the current lane"
                     },
                     {
                         "name": "pattern",
-                        "description": "partially merge the lane with the specified component-pattern"
+                        "description": "partially merge the lane - only components that match the specified component-pattern\nComponent pattern format: component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
                     }
                 ]
             },
@@ -3392,7 +3398,7 @@
                     [
                         "",
                         "verbose",
-                        "show details of components that were not merged legitimately"
+                        "show details of components that didn't need to be merged"
                     ],
                     [
                         "s",
@@ -3406,20 +3412,20 @@
                     ]
                 ],
                 "description": "abort the recent lane-merge. revert the lane object and checkout accordingly",
-                "extendedDescription": "restore the lane-object same as it was before the last \"bit lane merge\" command.\nalso, checkout the workspace components according to the restored lane",
+                "extendedDescription": "restore the lane-object to its state before the last \"bit lane merge\" command.\nalso, checkout the workspace components according to the restored lane state",
                 "private": true,
                 "remoteOp": true
             }
         ]
     },
     {
-        "name": "switch <lane> [pattern]",
+        "name": "switch <lane>",
         "alias": "",
         "options": [
             [
                 "n",
                 "alias <string>",
-                "relevant when the specified lane is a remote late. name a local lane differently than the remote lane"
+                "relevant when the specified lane is a remote lane. create a local alias for the lane (doesnt affect the lane's name on the remote"
             ],
             [
                 "m",
@@ -3429,17 +3435,17 @@
             [
                 "a",
                 "get-all",
-                "checkout all components in a lane include ones that do not exist in the workspace"
+                "checkout all components in a lane, including those not currently in the workspace"
             ],
             [
                 "x",
                 "skip-dependency-installation",
-                "do not install packages of the imported components"
+                "do not install dependencies of the imported components"
             ],
             [
                 "p",
                 "pattern <component-pattern>",
-                "switch only the specified component-pattern. works only when the workspace is empty"
+                "switch only the lane components matching the specified component-pattern. only works when the workspace is empty\n\ncomponent name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
             ],
             [
                 "j",
@@ -3454,7 +3460,7 @@
         "arguments": [
             {
                 "name": "lane",
-                "description": "lane-name or lane-id (if not exists locally) to switch to"
+                "description": "lane-name or lane-id (if lane is not local) to switch to"
             }
         ]
     },
@@ -3733,7 +3739,7 @@
             [
                 "i",
                 "ids",
-                "show only component ids unformatted"
+                "show only component ids, unformatted"
             ],
             [
                 "s",
@@ -3743,7 +3749,7 @@
             [
                 "o",
                 "outdated",
-                "show latest versions from remotes"
+                "highlight outdated components, in comparison with their latest remote version (if one exists)"
             ],
             [
                 "j",
@@ -3753,11 +3759,11 @@
             [
                 "n",
                 "namespace <string>",
-                "show only specified namespace by using wildcards"
+                "show only components in the specified namespace/s e.g. '-n ui' or '*/ui'"
             ]
         ],
-        "description": "list components on a workspace, local scope or a remote scope.",
-        "extendedDescription": "https://bit.dev/docs/reference/cli-reference#list",
+        "description": "list components on a workspace or a remote scope (with flag).",
+        "extendedDescription": "",
         "group": "discover",
         "private": false,
         "remoteOp": true,
@@ -3810,7 +3816,7 @@
             [
                 "",
                 "allow-staged",
-                "allow publish components that were not exported yet (not recommended)"
+                "allow publishing components that were not exported yet (not recommended)"
             ],
             [
                 "j",
@@ -3861,7 +3867,7 @@
             [
                 "",
                 "verbose",
-                "show extra data: full snap hashes for staged and divergence point for lanes"
+                "show extra data: full snap hashes for staged components, and divergence point for lanes"
             ],
             [
                 "l",
@@ -3874,7 +3880,7 @@
                 "in case issues found, exit with code 1"
             ]
         ],
-        "description": "present the current status of components in the workspace, and notifies when issues are detected",
+        "description": "present the current status of components in the workspace, including indication of detected issues",
         "extendedDescription": "",
         "group": "development",
         "private": false
@@ -3895,7 +3901,7 @@
             ]
         ],
         "description": "EXPERIMENTAL. basic status for fast execution",
-        "extendedDescription": "shows only modified/new components. for the full status, use \"bit status\".\nthe modified are components that their source code have changed, it doesn't check for config/aspect changes",
+        "extendedDescription": "shows only modified/new components with code changes. for the full status, use \"bit status\".\nthis command only checks source code changes, it doesn't check for config/aspect/dependency changes",
         "group": "development",
         "private": false,
         "arguments": [
@@ -3912,10 +3918,10 @@
             [
                 "j",
                 "json",
-                "return the component data in json format"
+                "return the component schema in json format"
             ]
         ],
-        "description": "shows the API schema of a certain component.",
+        "description": "shows the API schema of the specified component/s.",
         "extendedDescription": "you can use a `<pattern>` for multiple component ids, such as `bit schema \"org.scope/utils/**\"`.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nalways wrap the pattern with quotes to avoid collision with shell commands.\nuse `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.\n",
         "group": "development",
         "private": false
@@ -4002,7 +4008,7 @@
                     [
                         "d",
                         "debug",
-                        "show the origins were the aspects were taken from"
+                        "show the origins where the aspects were taken from"
                     ]
                 ],
                 "description": "list all aspects configured on component(s)",
@@ -4012,7 +4018,7 @@
                 "arguments": [
                     {
                         "name": "pattern",
-                        "description": "component name, component id, or component pattern. use component pattern to select multiple components. \nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+                        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
                     }
                 ]
             },
@@ -4023,7 +4029,7 @@
                     [
                         "d",
                         "debug",
-                        "show the origins were the aspects were taken from"
+                        "show the origins where the aspects were taken from"
                     ],
                     [
                         "j",
@@ -4031,14 +4037,14 @@
                         "format as json"
                     ]
                 ],
-                "description": "list the aspects set on a component, as well as their config and data",
+                "description": "list the aspects set on a component, as well as their configs and data",
                 "extendedDescription": "",
                 "group": "development",
                 "private": false,
                 "arguments": [
                     {
                         "name": "component-name",
-                        "description": "the component name or component id"
+                        "description": "the component name or component id to fetch aspects for"
                     }
                 ]
             },
@@ -4049,7 +4055,7 @@
                     [
                         "m",
                         "merge",
-                        "merge with an existing config if exits. (by default, it replaces the config)"
+                        "merge with an existing config if exits. (by default, it replaces overlapping existing configs)"
                     ]
                 ],
                 "description": "set components with an aspect to extend their development tools, metadata and (possibly) artifacts",
@@ -4059,7 +4065,7 @@
                 "arguments": [
                     {
                         "name": "pattern",
-                        "description": "the components to extend. use component name, component id, or component pattern. use component pattern to select multiple components. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\". wrap the pattern with quotes"
+                        "description": "the components to extend. component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
                     },
                     {
                         "name": "aspect-id",
@@ -4082,7 +4088,7 @@
                 "arguments": [
                     {
                         "name": "pattern",
-                        "description": "the components to target. use component name, component id, or component pattern. use component pattern to select multiple components. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\". wrap the pattern with quotes"
+                        "description": "the components to target. component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
                     },
                     {
                         "name": "aspect-id",
@@ -4094,28 +4100,28 @@
                 "name": "update <aspect-id> [pattern]",
                 "alias": "",
                 "options": [],
-                "description": "update a version of an aspect",
+                "description": "update a version of an aspect for all or specified components",
                 "extendedDescription": "",
                 "group": "development",
                 "private": false,
                 "arguments": [
                     {
                         "name": "aspect-id",
-                        "description": "the aspect's component id. optionally, add a version (id@version), otherwise, it finds the latest version on the remote"
+                        "description": "the aspect's component id. optionally, add a version (id@version), otherwise will use the latest version from the remote"
                     },
                     {
                         "name": "pattern",
-                        "description": "the components to update (defaults to all components). use component name, component id, or component pattern. use component pattern to select multiple components. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\". wrap the pattern with quotes"
+                        "description": "the components to update (defaults to all components). component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
                     }
                 ],
                 "examples": [
                     {
-                        "cmd": "update scope.org/aspect '**/ui/**'",
-                        "description": "update \"ui\" components that use scope.org/aspect to use its latest version"
+                        "cmd": "bit aspect update scope.org/aspect '**/ui/**'",
+                        "description": "update all components with the \"ui\" namespace that use scope.org/aspect, to use its latest version"
                     },
                     {
                         "cmd": "bit aspect update scope.org/aspect@2.0.0",
-                        "description": "update all components that use scope.org/aspect to version 2.0.0 (of this aspect)."
+                        "description": "update version of scope.org/aspect to version 2.0.0 for all components configured with that aspect."
                     }
                 ]
             }
@@ -4203,7 +4209,7 @@
             [
                 "",
                 "new-id <string>",
-                "if replaced by another component, enter the new component id"
+                "if replaced by another component, enter the new component id. alternatively use \"bit rename\" to do this automatically"
             ]
         ],
         "description": "deprecate a component",
@@ -4237,12 +4243,12 @@
             [
                 "s",
                 "scope <scope-name>",
-                "default scope for the newly created component"
+                "define the scope for the newly created component"
             ],
             [
                 "p",
                 "path <relative-path>",
-                "relative path in the workspace. by default the path is `<scope>/<namespace>/<name>`"
+                "relative path in the workspace to place new component in. by default, the directory of the new component is from your workspace's \"defaultScope\" value"
             ],
             [
                 "r",
@@ -4255,7 +4261,7 @@
                 "avoid renaming files and variables/classes according to the new component name"
             ]
         ],
-        "description": "rename component. if tagged/exported, create a new component and deprecate the original component",
+        "description": "rename component. if tagged/exported, create a new component and deprecate the original component. otherwise just renames current component",
         "extendedDescription": "",
         "group": "collaborate",
         "private": false,
@@ -4268,7 +4274,7 @@
             },
             {
                 "name": "new-name",
-                "description": "the new component name (without its scope name)"
+                "description": "the new component name (without its scope name. use --scope to define the new component's scope)"
             }
         ]
     },
@@ -4304,12 +4310,12 @@
             [
                 "",
                 "skip-config",
-                "do not copy the config (aspects-config) to the new component. helpful when it fails during aspect loading"
+                "do not copy the config (aspects-config, env, etc) to the new component. helpful when it fails during aspect loading"
             ],
             [
                 "",
                 "preserve",
-                "avoid renaming files and variables/classes according to the new component name"
+                "avoid refactoring file and variable/class names according to the new component name"
             ],
             [
                 "",
@@ -4317,7 +4323,7 @@
                 "avoid saving a reference to the original component"
             ]
         ],
-        "description": "create a new component out of an existing one (copies source files and config)",
+        "description": "create a new component forked from an existing one (copies source files and configs)",
         "extendedDescription": "",
         "group": "collaborate",
         "private": false,
@@ -4330,7 +4336,7 @@
             },
             {
                 "name": "target-component-name",
-                "description": "the name for the new component (component name without scope). to set a different scope, use the '--scope' flag"
+                "description": "the name for the new component (component name without scope, e.g. name/spaces/my-button). to set a different scope, use the '--scope' flag"
             }
         ]
     },
@@ -4341,7 +4347,7 @@
             [
                 "f",
                 "force",
-                "ignore local version. remove the components even when they are staged or modified"
+                "ignore local changes/versions. eject component/s even when they are staged or modified. Note: unexported tags/snaps will be lost"
             ],
             [
                 "j",
@@ -4354,14 +4360,14 @@
                 "keep the component files in the workspace intact"
             ]
         ],
-        "description": "replace components maintained in the workspace with their corresponding packages",
-        "extendedDescription": "",
+        "description": "remove component from the workspace and install it instead as a regular npm package.",
+        "extendedDescription": "By default the component files will be removed from the workspace",
         "group": "development",
         "private": false,
         "arguments": [
             {
                 "name": "component-pattern",
-                "description": "component name, component id, or component pattern.\nuse component pattern to select multiple components. use comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+                "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
             }
         ]
     },
@@ -4442,7 +4448,7 @@
             [
                 "",
                 "rebuild",
-                "allow signing components that their buildStatus is success for testing purposes"
+                "allow signing components whose buildStatus is successful for testing purposes"
             ]
         ],
         "description": "complete the build process for components",
@@ -4546,7 +4552,7 @@
                     [
                         "",
                         "dry-run-with-content",
-                        "use with --json flag. show the config content and the paths it will be written per env"
+                        "use with --json flag. show the config content and the paths that will be written per env"
                     ],
                     [
                         "v",
@@ -4576,12 +4582,12 @@
                     [
                         "w",
                         "writers <writers>",
-                        "only write config files for the given writers. use comma to separate multiple writers. use ws-config list to see all writers"
+                        "only clean config files for the given writers. use comma to separate multiple writers. use ws-config list to see all writers"
                     ],
                     [
                         "",
                         "dry-run",
-                        "show the paths that configs will be written per env"
+                        "show the paths of configs that will be cleaned"
                     ],
                     [
                         "j",