npm - @teambit/harmony.content.cli-reference - Versions diffs - 1.95.202 → 1.95.204 - Mend

@teambit/harmony.content.cli-reference 1.95.202 → 1.95.204

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/cli-reference.docs.mdx +1 -1
package/cli-reference.json +242 -236
package/cli-reference.mdx +423 -408
package/dist/cli-reference.composition.d.ts +2 -2
package/dist/cli-reference.docs.mdx +1 -1
package/dist/cli-reference.json +242 -236
package/dist/cli-reference.mdx.js +284 -244
package/dist/cli-reference.mdx.js.map +1 -1
package/dist/preview-1692345627885.js +7 -0
package/package-tar/teambit-harmony.content.cli-reference-1.95.204.tgz +0 -0
package/package.json +2 -2
package/dist/preview-1692282707573.js +0 -7
package/package-tar/teambit-harmony.content.cli-reference-1.95.202.tgz +0 -0

package/dist/cli-reference.mdx.js CHANGED Viewed

@@ -97,7 +97,7 @@ function MDXContent(_ref) {
   }, "-m")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "define entry point for the components")), (0, _react2.mdx)("tr", {
+  }, "define component entry point")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -142,7 +142,7 @@ function MDXContent(_ref) {
   }, "-s")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "sets the component's scope-name. if not entered, the default-scope will be used")), (0, _react2.mdx)("tr", {
+  }, "sets the component's scope. if not entered, the default-scope from workspace.jsonc will be used")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -230,7 +230,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "app run <app-name>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": run an app (independent of bit's dev server)"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": locally run an app component (independent of bit's dev server)"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -307,7 +307,7 @@ function MDXContent(_ref) {
   }, "-p")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "port of the app")), (0, _react2.mdx)("tr", {
+  }, "port to run the app on")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -322,7 +322,7 @@ function MDXContent(_ref) {
   }, "-v")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "showing verbose output for inspection and prints stack trace")), (0, _react2.mdx)("tr", {
+  }, "show verbose output for inspection and print stack trace")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -350,7 +350,7 @@ function MDXContent(_ref) {
     "align": null
   }, "run app in server side rendering mode.")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "artifacts"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list and download components artifacts", (0, _react2.mdx)("br", {
+  }, "Description"), ": list and download component artifacts", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "artifacts are created on isolated capsules during tag or snap commands.", (0, _react2.mdx)("br", {
     parentName: "p"
@@ -529,13 +529,13 @@ function MDXContent(_ref) {
   }, "-d")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show the origins were the aspects were taken from")))), (0, _react2.mdx)("h3", null, "aspect get"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "show the origins where the aspects were taken from")))), (0, _react2.mdx)("h3", null, "aspect get"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "aspect get <component-name>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list the aspects set on a component, as well as their config and data"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": list the aspects set on a component, as well as their configs and data"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -561,7 +561,7 @@ function MDXContent(_ref) {
   }, "component-name")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "the component name or component id")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "the component name or component id to fetch aspects for")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -597,7 +597,7 @@ function MDXContent(_ref) {
   }, "-d")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show the origins were the aspects were taken from")), (0, _react2.mdx)("tr", {
+  }, "show the origins where the aspects were taken from")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -644,7 +644,7 @@ function MDXContent(_ref) {
   }, "pattern")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "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")), (0, _react2.mdx)("tr", {
+  }, "the components to extend. 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")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -700,7 +700,7 @@ function MDXContent(_ref) {
   }, "-m")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "merge with an existing config if exits. (by default, it replaces the config)")))), (0, _react2.mdx)("h3", null, "aspect unset"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "merge with an existing config if exits. (by default, it replaces overlapping existing configs)")))), (0, _react2.mdx)("h3", null, "aspect unset"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -732,7 +732,7 @@ function MDXContent(_ref) {
   }, "pattern")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "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")), (0, _react2.mdx)("tr", {
+  }, "the components to target. 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")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -748,7 +748,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "aspect update <aspect-id> [pattern]")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": update a version of an aspect"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": update a version of an aspect for all or specified components"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -774,7 +774,7 @@ function MDXContent(_ref) {
   }, "aspect-id")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "the aspect's component id. optionally, add a version (id@version), otherwise, it finds the latest version on the remote")), (0, _react2.mdx)("tr", {
+  }, "the aspect's component id. optionally, add a version (id@version), otherwise will use the latest version from the remote")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -784,9 +784,11 @@ function MDXContent(_ref) {
   }, "pattern")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "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")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "build"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "the components to update (defaults to all components). 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")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "build"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+    parentName: "p"
+  }, "Description"), ": run set of tasks for build.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }, "Description"), ": run set of tasks for build"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "by default, only new and modified components are built"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit build [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -958,7 +960,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "skip running component tests during tag process")), (0, _react2.mdx)("tr", {
+  }, "skip running component tests during build process")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -971,7 +973,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "stop pipeline execution on the first failed task (by default a task is skipped only when its dependent failed)")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "capsule"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "stop pipeline execution on the first failed task (by default a task is skipped only when its dependency failed)")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "capsule"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Description"), ": manage capsules", (0, _react2.mdx)("br", {
     parentName: "p"
@@ -1371,7 +1373,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", "", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit checkout head [component-pattern]"), " => checkout to the last snap/tag, omit ", "[component-pattern]", " to checkout head for all", (0, _react2.mdx)("br", {
+  }, "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", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -1505,7 +1507,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "in case of a conflict, resolve according to the strategy: ", "[ours, theirs, manual]")), (0, _react2.mdx)("tr", {
+  }, "in case of merge conflict, resolve according to the provided strategy: ", "[ours, theirs, manual]")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -1550,7 +1552,7 @@ function MDXContent(_ref) {
   }, "-e")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "when on a lane, avoid introducing new components from the remote lane that do not exist locally")), (0, _react2.mdx)("tr", {
+  }, "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")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -1580,7 +1582,7 @@ function MDXContent(_ref) {
   }, "-x")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "do not install packages of the imported components")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "clear-cache"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "do not auto-install dependencies of the imported components")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "clear-cache"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Alias"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -1827,8 +1829,8 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("a", {
     parentName: "p",
-    "href": "https://bit.dev/reference/config/bit-config"
-  }, "https://bit.dev/reference/config/bit-config")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+    "href": "https://bit.dev/docs/config/bit-config"
+  }, "https://bit.dev/docs/config/bit-config")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit config")), (0, _react2.mdx)("h3", null, "config set"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -1848,7 +1850,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "config get <key>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": get a global configuration"), (0, _react2.mdx)("h3", null, "config list"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "Description"), ": get a value from global configuration"), (0, _react2.mdx)("h3", null, "config list"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -2081,7 +2083,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "if replaced by another component, enter the new component id")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "deps"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "if replaced by another component, enter the new component id. alternatively use \"bit rename\" to do this automatically")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "deps"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Alias"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -2609,15 +2611,15 @@ function MDXContent(_ref) {
     "align": "center"
   }, "package-name. for components, you can use either component-id or package-name. if version is specified, it will search for the exact version")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "diff"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": show the diff between the components' source files and config", (0, _react2.mdx)("br", {
+  }, "Description"), ": show the diff between the components' current source files and config, and their latest snapshot or tag", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "bit diff => compare all modified components to their model version", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "bit diff ", "[ids...]", " => compare the specified components against their modified states", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "bit diff ", "[id][version]", " => compare the specified version to used or modified files", (0, _react2.mdx)("br", {
+  }), "\n", "bit diff ", "[id][version]", " => compare component's current files and configs to the specified version of the component", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "bit diff ", "[id][version]", " ", "[to_version]", " => compare the specified version files to to_version files", (0, _react2.mdx)("br", {
+  }), "\n", "bit diff ", "[id][version]", " ", "[to_version]", " => compare component's files and configs between the specified version and the to_version provided", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "you can use a pattern for multiple ids, such as bit diff \"utils/", "*", "\". (wrap the pattern with quotes to avoid collision with shell commands)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -2657,7 +2659,7 @@ function MDXContent(_ref) {
   }, "-v")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show a more verbose output when possible")), (0, _react2.mdx)("tr", {
+  }, "show a more verbose output where possible")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -2763,7 +2765,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": replace components maintained in the workspace with their corresponding packages"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": remove component from the workspace and install it instead as a regular npm package.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "By default the component files will be removed from the workspace"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit eject <component-pattern>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -2827,7 +2831,7 @@ function MDXContent(_ref) {
   }, "-f")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "ignore local version. remove the components even when they are staged or modified")), (0, _react2.mdx)("tr", {
+  }, "ignore local changes/versions. eject component/s even when they are staged or modified. Note: unexported tags/snaps will be lost")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -2861,6 +2865,8 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "component.json"), " file)", (0, _react2.mdx)("br", {
     parentName: "p"
+  }), "\n", "note this can be reversed at any time by snapping/tagging changes and deleting the component.json file", (0, _react2.mdx)("br", {
+    parentName: "p"
   }), "\n", "you can use a ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "<pattern>"), " for multiple component ids, such as ", (0, _react2.mdx)("inlineCode", {
@@ -2913,7 +2919,7 @@ function MDXContent(_ref) {
   }, "-p")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "mark propagate true in the config file")), (0, _react2.mdx)("tr", {
+  }, "mark propagate true in the config file, so that component.json configs will be merge with workspace configs")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -2944,13 +2950,13 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "envs list")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list all envs available in the workspace"), (0, _react2.mdx)("h3", null, "envs get"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "Description"), ": list all envs currently used in the workspace"), (0, _react2.mdx)("h3", null, "envs get"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "envs get <component-name>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": show information about a component's env"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": show config information from a component's env"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -2976,7 +2982,7 @@ function MDXContent(_ref) {
   }, "component-name")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "the 'component name' or 'component id' of the component its env you'd like to inspect")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "the 'component name' or 'component id' of the component whose env you'd like to inspect")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -3016,7 +3022,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "envs set <component-pattern> <env>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": Sets one or more components with a development environment (env)"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": Assigns one or more components a development environment (env)"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -3052,7 +3058,7 @@ function MDXContent(_ref) {
   }, "env")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "the env's component id (include version for non-core envs. e.g, ", (0, _react2.mdx)("inlineCode", {
+  }, "the env's component id (include version if not latest, e.g ", (0, _react2.mdx)("inlineCode", {
     parentName: "td"
   }, "teambit.community/envs/community-react@1.95.13"), ")")))), (0, _react2.mdx)("h3", null, "envs unset"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -3062,11 +3068,11 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Description"), ": un-sets an env from components that were previously set by \"bit env set\" or by a component template", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "keep in mind that this doesn't remove envs that are set in the variants.", (0, _react2.mdx)("br", {
+  }), "\n", "keep in mind that this doesn't remove envs that are set via variants.", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "in only removes envs that appear in the .bitmap file, which were previously configured via \"bit env set\".", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "the purpose of this command is to remove the specific settings and let the the variants in workspace.jsonc to control the env.", (0, _react2.mdx)("br", {
+  }), "\n", "the purpose of this command is to reset previously assigned envs to either allow variants configure the env or use the base node env.", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "you can use a ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -3140,7 +3146,7 @@ function MDXContent(_ref) {
   }, "current-env")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "the component id of the current env")), (0, _react2.mdx)("tr", {
+  }, "the component id of the env to be replaced")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -3182,7 +3188,7 @@ function MDXContent(_ref) {
   }, "env-id")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "the environment id (defaults to all envs). optionally, add a version (id@version), otherwise, it finds the latest version on the remote.")), (0, _react2.mdx)("tr", {
+  }, "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.")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -3192,7 +3198,7 @@ function MDXContent(_ref) {
   }, "pattern")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "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")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "export"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "the components to update (defaults to all components). 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")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "export"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Alias"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -3202,13 +3208,15 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Description"), ": export components from the workspace to remote scopes", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "bit export => export all staged components to their current scope, if checked out to a lane, export the lane as well", (0, _react2.mdx)("br", {
+  }), "\n", "bit export => export all staged snaps/tags of components to their remote scope. if checked out to a lane, export the lane as well", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit export [id...]"), " => export the given ids to their current scope", (0, _react2.mdx)("br", {
+  }, "bit export [pattern...]"), " => export components included by the pattern to their remote scope (we recommend not using a pattern in", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\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)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "most scenarios so that all changes are exported simultaneously)", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\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)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit export [component-patterns...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -3236,7 +3244,7 @@ function MDXContent(_ref) {
   }, "component-patterns...")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "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)")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "(not recommended) 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")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -3272,7 +3280,7 @@ function MDXContent(_ref) {
   }, "-e")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "replace the exported components with their corresponding packages (to use these components without further maintaining them)")), (0, _react2.mdx)("tr", {
+  }, "remove component from the workspace and install it instead as a regular npm package")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -3369,7 +3377,7 @@ function MDXContent(_ref) {
     "align": null
   }, "show output in json format")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "fork"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": create a new component out of an existing one (copies source files and config)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": create a new component forked from an existing one (copies source files and configs)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit fork <source-component-id> [target-component-name]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -3407,7 +3415,7 @@ function MDXContent(_ref) {
   }, "target-component-name")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "the name for the new component (component name without scope). to set a different scope, use the '--scope' flag")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "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")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -3518,7 +3526,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "do not copy the config (aspects-config) to the new component. helpful when it fails during aspect loading")), (0, _react2.mdx)("tr", {
+  }, "do not copy the config (aspects-config, env, etc) to the new component. helpful when it fails during aspect loading")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -3531,7 +3539,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "avoid renaming files and variables/classes according to the new component name")), (0, _react2.mdx)("tr", {
+  }, "avoid refactoring file and variable/class names according to the new component name")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -3706,7 +3714,7 @@ function MDXContent(_ref) {
     "align": null
   }, "json format")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "graph"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": generate an image file with the dependencies graph"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": generate an image file with the workspace components' dependencies graph"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit graph [id]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -3744,7 +3752,7 @@ function MDXContent(_ref) {
   }, "-i")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "image path. use one of the following extensions: ", "[gif, png, svg, pdf]")), (0, _react2.mdx)("tr", {
+  }, "image path and format. use one of the following extensions: ", "[gif, png, svg, pdf]")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -3925,22 +3933,7 @@ function MDXContent(_ref) {
   }, "-o")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "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")), (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "--display-dependencies")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "-d")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "display the imported dependencies")), (0, _react2.mdx)("tr", {
+  }, "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")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4000,7 +3993,7 @@ function MDXContent(_ref) {
   }, "-x")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "do not install packages of the imported components")), (0, _react2.mdx)("tr", {
+  }, "do not auto-install dependencies of the imported components")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4028,7 +4021,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "import all dependencies and write them to the workspace")), (0, _react2.mdx)("tr", {
+  }, "import all dependencies (bit components only) of imported components and write them to the workspace")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4041,7 +4034,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "import components found while traversing from the given ids upwards to the workspace components")), (0, _react2.mdx)("tr", {
+  }, "import components found while traversing from the imported components upwards to the workspace components")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4054,7 +4047,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "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)")), (0, _react2.mdx)("tr", {
+  }, "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)")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4080,7 +4073,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "fetch dependencies objects")), (0, _react2.mdx)("tr", {
+  }, "fetch dependencies (bit components) objects to the local scope, but dont add to the workspace. Useful to resolve errors about missing dependency data")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4093,7 +4086,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "do not write any file, just create .bitmap entries of the imported components")), (0, _react2.mdx)("tr", {
+  }, "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")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4222,7 +4215,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "same as reset-new, but it only reset components belong to lanes. main components are left intact")), (0, _react2.mdx)("tr", {
+  }, "same as reset-new, but it only resets components belong to lanes. main components are left intact")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4235,7 +4228,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "delete all Bit files and directories, including Bit configuration, tracking and model data. Useful for re-start using Bit from scratch")), (0, _react2.mdx)("tr", {
+  }, "delete all Bit files and directories, including Bit configuration, tracking and model data. Useful for re-starting workspace from scratch")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4248,7 +4241,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "removes local scope (.bit or .git/bit). snaps that were not exported will be lost. workspace left intact")), (0, _react2.mdx)("tr", {
+  }, "removes local scope (.bit or .git/bit). tags/snaps that have not been exported will be lost. workspace is left intact")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4263,7 +4256,7 @@ function MDXContent(_ref) {
   }, "-d")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "set up default directory to import components into")), (0, _react2.mdx)("tr", {
+  }, "set the default directory pattern to import/create components into")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4276,7 +4269,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "set up default scope for all components in the workspace")), (0, _react2.mdx)("tr", {
+  }, "set the default scope for components in the workspace")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4291,7 +4284,7 @@ function MDXContent(_ref) {
   }, "-p")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "set up package manager (npm or yarn)")), (0, _react2.mdx)("tr", {
+  }, "set the package manager (npm or yarn) to be used in the workspace")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4423,7 +4416,7 @@ function MDXContent(_ref) {
   }, "-u")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "update all dependencies")), (0, _react2.mdx)("tr", {
+  }, "update all dependencies to latest version according to their semver range")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4548,15 +4541,15 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": manage lanes"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": manage lanes - if no sub-command is used, runs \"bit lane list\""), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit lane [lane-name]")), (0, _react2.mdx)("h3", null, "lane list"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "bit lane [sub-command]")), (0, _react2.mdx)("h3", null, "lane list"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "lane list")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list lanes"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": list local lanes"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -4607,7 +4600,7 @@ function MDXContent(_ref) {
   }, "-j")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show lanes details in a json format")), (0, _react2.mdx)("tr", {
+  }, "show lanes' details in a json format")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4622,7 +4615,7 @@ function MDXContent(_ref) {
   }, "-r")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show remote lanes")), (0, _react2.mdx)("tr", {
+  }, "show all remote lanes from the specified scope")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4635,7 +4628,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show merged lanes")), (0, _react2.mdx)("tr", {
+  }, "list only merged lanes")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4648,11 +4641,11 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show lanes that are not merged")))), (0, _react2.mdx)("h3", null, "lane switch"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "list only lanes that haven't been merged")))), (0, _react2.mdx)("h3", null, "lane switch"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "lane switch <lane> [pattern]")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "lane switch <lane>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Description"), ": switch to the specified lane"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -4680,7 +4673,7 @@ function MDXContent(_ref) {
   }, "lane")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "lane-name or lane-id (if not exists locally) to switch to")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "lane-name or lane-id (if lane is not local) to switch to")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -4716,7 +4709,7 @@ function MDXContent(_ref) {
   }, "-n")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "relevant when the specified lane is a remote late. name a local lane differently than the remote lane")), (0, _react2.mdx)("tr", {
+  }, "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")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4746,7 +4739,7 @@ function MDXContent(_ref) {
   }, "-a")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "checkout all components in a lane include ones that do not exist in the workspace")), (0, _react2.mdx)("tr", {
+  }, "checkout all components in a lane, including those not currently in the workspace")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4761,7 +4754,7 @@ function MDXContent(_ref) {
   }, "-x")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "do not install packages of the imported components")), (0, _react2.mdx)("tr", {
+  }, "do not install dependencies of the imported components")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4776,7 +4769,7 @@ function MDXContent(_ref) {
   }, "-p")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "switch only the specified component-pattern. works only when the workspace is empty")), (0, _react2.mdx)("tr", {
+  }, "switch only the lane components matching the specified component-pattern. only works when the workspace is empty 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")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4848,7 +4841,7 @@ function MDXContent(_ref) {
   }, "-r")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show the lane from remote")))), (0, _react2.mdx)("h3", null, "lane create"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "show details of the remote head of the provided lane")))), (0, _react2.mdx)("h3", null, "lane create"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -4858,7 +4851,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", "a lane created from main (default-lane) is empty until components are snapped.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "a lane created from another lane has all the components of the original lane."), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }), "\n", "a lane created from another lane contains all the components of the original lane."), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -4920,7 +4913,7 @@ function MDXContent(_ref) {
   }, "-s")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "remote scope where this lane will be exported to, default to the defaultScope (can be changed later with \"bit lane change-scope\")")), (0, _react2.mdx)("tr", {
+  }, "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\")")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4961,13 +4954,13 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "allow forking a lane into a different scope than the original lane")))), (0, _react2.mdx)("h3", null, "lane remove"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "create the new lane in a different scope than its parent lane (if created from another lane)")))), (0, _react2.mdx)("h3", null, "lane remove"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "lane remove <lanes...>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": remove lanes"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": remove or delete lanes"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -5029,7 +5022,7 @@ function MDXContent(_ref) {
   }, "-r")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "remove a remote lane (in the lane arg, use remote/lane-id syntax)")), (0, _react2.mdx)("tr", {
+  }, "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")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5044,7 +5037,7 @@ function MDXContent(_ref) {
   }, "-f")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "removes the lane even when the lane was not merged yet")), (0, _react2.mdx)("tr", {
+  }, "removes/deletes the lane even when the lane is not yet merged to main")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5065,7 +5058,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "lane change-scope <lane-name> <remote-scope-name>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": changes the remote scope of a lane"), (0, _react2.mdx)("h3", null, "lane alias"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "Description"), ": changes the remote scope of a lane", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "NOTE: available only before the lane is exported to the remote"), (0, _react2.mdx)("h3", null, "lane alias"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -5073,9 +5068,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Description"), ": adds an alias to a lane", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "an alias is a name that can be used to refer to a lane. it is saved locally and never reach the remote.", (0, _react2.mdx)("br", {
+  }), "\n", "an alias is a name that can be used locally to refer to a lane. it is saved locally and never reaches the remote.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "it is useful when having multiple lanes with the same name, but with different remote scopes."), (0, _react2.mdx)("h3", null, "lane rename"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }), "\n", "it is useful e.g. when having multiple lanes with the same name, but with different remote scopes."), (0, _react2.mdx)("h3", null, "lane rename"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -5102,6 +5097,42 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("strong", {
     parentName: "th"
+  }, "Arg")), (0, _react2.mdx)("th", {
+    parentName: "tr",
+    "align": "center"
+  }, (0, _react2.mdx)("strong", {
+    parentName: "th"
+  }, "Description")))), (0, _react2.mdx)("tbody", {
+    parentName: "table"
+  }, (0, _react2.mdx)("tr", {
+    parentName: "tbody"
+  }, (0, _react2.mdx)("td", {
+    parentName: "tr",
+    "align": null
+  }, (0, _react2.mdx)("inlineCode", {
+    parentName: "td"
+  }, "from")), (0, _react2.mdx)("td", {
+    parentName: "tr",
+    "align": "center"
+  }, "base lane for comparison")), (0, _react2.mdx)("tr", {
+    parentName: "tbody"
+  }, (0, _react2.mdx)("td", {
+    parentName: "tr",
+    "align": null
+  }, (0, _react2.mdx)("inlineCode", {
+    parentName: "td"
+  }, "to")), (0, _react2.mdx)("td", {
+    parentName: "tr",
+    "align": "center"
+  }, "lane being compared to base lane")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+    parentName: "table"
+  }, (0, _react2.mdx)("tr", {
+    parentName: "thead"
+  }, (0, _react2.mdx)("th", {
+    parentName: "tr",
+    "align": null
+  }, (0, _react2.mdx)("strong", {
+    parentName: "th"
   }, "Option")), (0, _react2.mdx)("th", {
     parentName: "tr",
     "align": "center"
@@ -5127,13 +5158,13 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show lane-diff for the specified component-pattern only")))), (0, _react2.mdx)("h3", null, "lane add-readme"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "show lane-diff for components conforming to the specified component-pattern only component-pattern format: 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")))), (0, _react2.mdx)("h3", null, "lane add-readme"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "lane add-readme <component-name> [lane-name]")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": EXPERIMENTAL. adds a readme component to a lane"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": EXPERIMENTAL. sets an existing component as the readme of a lane"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -5181,7 +5212,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "lane import <lane>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": import a remote lane to your workspace"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": import a remote lane to your workspace and switch to that lane"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -5243,7 +5274,7 @@ function MDXContent(_ref) {
   }, "-x")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "do not install packages of the imported components")), (0, _react2.mdx)("tr", {
+  }, "do not install dependencies of the imported components")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5258,7 +5289,7 @@ function MDXContent(_ref) {
   }, "-p")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "switch only the specified component-pattern. works only when the workspace is empty")))), (0, _react2.mdx)("h3", null, "lane remove-comp"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "import only components from the lane that fit the specified component-pattern to the workspace. works only when the workspace is empty")))), (0, _react2.mdx)("h3", null, "lane remove-comp"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -5266,9 +5297,11 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Description"), ": remove components when on a lane", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "in case the components are part of the lane and the lane is exported, it marks the components as removed,", (0, _react2.mdx)("br", {
+  }), "\n", "in case the components are part of the lane and the lane is exported, it marks the components as", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "removed from the lane, and then after snap+export, the remote-lane gets updated as well.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "and then after snap+export, the remote-lane gets updated as well. upon lane-merge, these components are skipped."), (0, _react2.mdx)("p", null, "in case the components are not part of the lane or the lane is new, it simply removes the components from the workspace"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }), "\n", "upon lane-merge, these removed components are skipped and any changes for removed components won't be merged to main."), (0, _react2.mdx)("p", null, "in case the components are not yet part of the lane or the lane is new, it simply removes the components from the workspace"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -5328,7 +5361,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "do not mark the components as removed. instead, remove them from the workspace only")), (0, _react2.mdx)("tr", {
+  }, "do not mark the components as removed from the lane. instead, remove them from the workspace only")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5341,19 +5374,19 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "EXPERIMENTAL. mark as removed on main after merging this lane into main")))), (0, _react2.mdx)("h3", null, "lane merge"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "EXPERIMENTAL. remove, i.e. delete, component/s on the main lane after merging this lane into main")))), (0, _react2.mdx)("h3", null, "lane merge"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "lane merge <lane> [pattern]")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": merge a local or a remote lane", (0, _react2.mdx)("br", {
+  }, "Description"), ": merge a local or a remote lane to the current lane", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "by default, the provided lane will be fetched from the remote before merging.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "to merge the lane from the local scope without updating it first, use \"--skip-fetch\" flag."), (0, _react2.mdx)("p", null, "when the current and the other lanes are diverged in history and the files could be merged with no conflicts,", (0, _react2.mdx)("br", {
+  }), "\n", "to merge the lane from the local scope without updating it first, use \"--skip-fetch\" flag."), (0, _react2.mdx)("p", null, "when the current and merge candidate lanes are diverged in history and the files could be merged with no conflicts,", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "it will snap-merge these components to complete the merge. use \"no-snap\" to opt-out, or \"tag\" to tag instead"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }), "\n", "these components will be snap-merged to complete the merge. use \"no-snap\" to opt-out, or \"tag\" to tag instead"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -5379,7 +5412,7 @@ function MDXContent(_ref) {
   }, "lane")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "lane-name or lane-id (if not exists locally) to merge to the current lane")), (0, _react2.mdx)("tr", {
+  }, "lane-name or full lane-id (if remote) to merge to the current lane")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5389,7 +5422,7 @@ function MDXContent(_ref) {
   }, "pattern")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "partially merge the lane with the specified component-pattern")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "partially merge the lane - only components that match the specified component-pattern Component pattern format: 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")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -5423,7 +5456,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "DEPRECATED. use --auto-merge-resolve. In the future, this flag will leave the current code intact")), (0, _react2.mdx)("tr", {
+  }, "DEPRECATED. use --auto-merge-resolve. in case of a conflict, keep local modifications")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5436,7 +5469,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "DEPRECATED. use --auto-merge-resolve. In the future, this flag will override the current code with the incoming code")), (0, _react2.mdx)("tr", {
+  }, "DEPRECATED. use --auto-merge-resolve. in case of a conflict, override local with incoming changes")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5462,7 +5495,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "in case of a conflict, resolve according to the strategy: ", "[ours, theirs, manual]")), (0, _react2.mdx)("tr", {
+  }, "in case of a merge conflict, resolve according to the provided strategy: ", "[ours, theirs, manual]")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5475,7 +5508,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "merge only components in a lane that exist in the workspace")), (0, _react2.mdx)("tr", {
+  }, "merge only lane components that are in the current workspace")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5488,7 +5521,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "do not auto snap in case the merge completed without conflicts")), (0, _react2.mdx)("tr", {
+  }, "do not auto snap after merge completed without conflicts")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5501,7 +5534,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "tag all lane components after merging into main (also tag-merge in case of snap-merge)")), (0, _react2.mdx)("tr", {
+  }, "auto-tag all lane components after merging into main (or tag-merge in case of snap-merge)")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5555,7 +5588,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "relevant for merging lanes into main, which by default squash")), (0, _react2.mdx)("tr", {
+  }, "relevant for merging lanes into main, which by default squashes all lane snaps")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5568,7 +5601,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "EXPERIMENTAL. relevant for merging a lane into another lane, which by default does not squash")), (0, _react2.mdx)("tr", {
+  }, "EXPERIMENTAL. relevant for merging a lane into another non-main lane, which by default does not squash")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5581,7 +5614,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "allow merging when component are modified due to config changes (such as dependencies) only and not files")), (0, _react2.mdx)("tr", {
+  }, "allow merging when components are modified due to config changes (such as dependencies) only and not files")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5594,7 +5627,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show details of components that were not merged legitimately")), (0, _react2.mdx)("tr", {
+  }, "show details of components that were not merged successfully")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5609,7 +5642,7 @@ function MDXContent(_ref) {
   }, "-x")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "do not install packages of the imported components")), (0, _react2.mdx)("tr", {
+  }, "do not install dependencies of the imported components")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5622,7 +5655,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "use the current target-lane if exits locally without updating it from the remote")), (0, _react2.mdx)("tr", {
+  }, "use the local state of target-lane if exits locally, without updating it from the remote")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5635,7 +5668,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "relevant for \"--pattern\" and \"--workspace\". merge also dependencies of the given components")), (0, _react2.mdx)("tr", {
+  }, "relevant for \"--pattern\" and \"--workspace\". merge also dependencies of the specified components")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5648,7 +5681,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "relevant when a component on a lane and the component on main has nothing in common. merge-strategy can be \"ours\" (default) or \"theirs\"")), (0, _react2.mdx)("tr", {
+  }, "relevant when a component on a lane and the component on main have nothing in common. merge-strategy can be \"ours\" (default) or \"theirs\"")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5669,9 +5702,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Description"), ": abort the recent lane-merge. revert the lane object and checkout accordingly", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "restore the lane-object same as it was before the last \"bit lane merge\" command.", (0, _react2.mdx)("br", {
+  }), "\n", "restore the lane-object to its state before the last \"bit lane merge\" command.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "also, checkout the workspace components according to the restored lane"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }), "\n", "also, checkout the workspace components according to the restored lane state"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -5705,7 +5738,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show details of components that were not merged legitimately")), (0, _react2.mdx)("tr", {
+  }, "show details of components that didn't need to be merged")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5793,7 +5826,7 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--remote <string>")), (0, _react2.mdx)("td", {
+  }, "--remote <remote-scope-name>")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
   }, (0, _react2.mdx)("inlineCode", {
@@ -5801,7 +5834,7 @@ function MDXContent(_ref) {
   }, "-r")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show remote lanes")), (0, _react2.mdx)("tr", {
+  }, "show all remote lanes from the specified scope")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5814,7 +5847,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show merged lanes")), (0, _react2.mdx)("tr", {
+  }, "list only merged lanes")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5827,7 +5860,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show not merged lanes")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "link"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "list only lanes that haven't been merged")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "link"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Description"), ": create links in the node_modules directory, to core aspects and to components in the workspace"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -6038,12 +6071,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list components on a workspace, local scope or a remote scope.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", (0, _react2.mdx)("a", {
-    parentName: "p",
-    "href": "https://bit.dev/docs/reference/cli-reference#list"
-  }, "https://bit.dev/docs/reference/cli-reference#list")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": list components on a workspace or a remote scope (with flag)."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit list [remote-scope]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -6081,7 +6109,7 @@ function MDXContent(_ref) {
   }, "-i")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show only component ids unformatted")), (0, _react2.mdx)("tr", {
+  }, "show only component ids, unformatted")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6111,7 +6139,7 @@ function MDXContent(_ref) {
   }, "-o")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show latest versions from remotes")), (0, _react2.mdx)("tr", {
+  }, "highlight outdated components, in comparison with their latest remote version (if one exists)")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6141,7 +6169,7 @@ function MDXContent(_ref) {
   }, "-n")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show only specified namespace by using wildcards")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "log"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "show only components in the specified namespace/s e.g. '-n ui' or '", "*", "/ui'")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "log"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Description"), ": show components(s) version history"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -6426,15 +6454,17 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "specify machine-name to pair with the token (useful for CI to avoid accidentally revoke the token)")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "logout"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "specify machine-name to pair with the token (useful for CI to avoid accidentally revoking the token)")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "logout"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Description"), ": log the CLI out of Bit"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit logout")), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "merge"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": merge changes of the remote head into local", (0, _react2.mdx)("br", {
+  }, "Description"), ": merge changes of the remote head into local - auto-snaps all merged components", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "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", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "merge changes of the remote head into local. when on a lane, merge the remote head of the lane into the local.", (0, _react2.mdx)("br", {
+  }), "\n", "and creates snaps for merged components that have diverged, on the lane.", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "if no ids are specified, all pending-merge components will be merged. (run \"bit status\" to list them).", (0, _react2.mdx)("br", {
     parentName: "p"
@@ -6476,7 +6506,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "DEPRECATED. use --auto-merge-resolve. In the future, this flag will leave the current code intact")), (0, _react2.mdx)("tr", {
+  }, "DEPRECATED. use --auto-merge-resolve. in case of a conflict, keep the local modification")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6489,7 +6519,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "DEPRECATED. use --auto-merge-resolve. In the future, this flag will override the current code with the incoming code")), (0, _react2.mdx)("tr", {
+  }, "DEPRECATED. use --auto-merge-resolve. in case of a conflict, override the local modification with the specified version")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6528,7 +6558,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "in case of an unresolved merge, revert to the state before the merge began")), (0, _react2.mdx)("tr", {
+  }, "in case of an unresolved merge, revert to pre-merge state")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6554,7 +6584,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "do not auto snap in case the merge completed without conflicts")), (0, _react2.mdx)("tr", {
+  }, "do not auto snap even if the merge completed without conflicts")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6580,7 +6610,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show details of components that were not merged legitimately")), (0, _react2.mdx)("tr", {
+  }, "show details of components that were not merged successfully")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6595,7 +6625,7 @@ function MDXContent(_ref) {
   }, "-x")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "do not install packages of the imported components")), (0, _react2.mdx)("tr", {
+  }, "do not install new dependencies resulting from the merge")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6620,9 +6650,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Description"), ": EXPERIMENTAL. basic status for fast execution", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "shows only modified/new components. for the full status, use \"bit status\".", (0, _react2.mdx)("br", {
+  }), "\n", "shows only modified/new components with code changes. for the full status, use \"bit status\".", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "the modified are components that their source code have changed, it doesn't check for config/aspect changes"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "this command only checks source code changes, it doesn't check for config/aspect/dependency changes"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit mini-status [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -6707,14 +6737,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": move a component to a different filesystem path", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "move files or directories of component(s)", (0, _react2.mdx)("br", {
+  }, "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)", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "", (0, _react2.mdx)("a", {
-    parentName: "p",
-    "href": "https://bit.dev/docs/workspace/moving-components"
-  }, "https://bit.dev/docs/workspace/moving-components")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "move files or directories of component(s)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit move <current-component-dir> <new-component-dir>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -6742,7 +6767,7 @@ function MDXContent(_ref) {
   }, "current-component-dir")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "the current relative path (in the workspace) to the component directory")), (0, _react2.mdx)("tr", {
+  }, "the component's current directory (relative to the workspace root)")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6752,7 +6777,7 @@ function MDXContent(_ref) {
   }, "new-component-dir")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "the new relative path (in the workspace) to the component directory")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "new"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "the new directory (relative to the workspace root) to create and move the component's files to")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "new"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Description"), ": create a new workspace from a template"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -6782,7 +6807,7 @@ function MDXContent(_ref) {
   }, "template-name")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "the name of the workspace template (run 'bit templates', outside of a workspace, to get a list of available templates)")), (0, _react2.mdx)("tr", {
+  }, "the name of the workspace template (run 'bit templates' outside of a workspace to get a list of available workspace templates)")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6792,7 +6817,7 @@ function MDXContent(_ref) {
   }, "workspace-name")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "the name for the new workspace and workspace directory")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "the name for the new workspace and workspace directory that will be created")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -6828,7 +6853,7 @@ function MDXContent(_ref) {
   }, "-a")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "aspect-id of the template. mandatory for non-core aspects. helpful for core aspects in case of a name collision")), (0, _react2.mdx)("tr", {
+  }, "id of the aspect that registered the template, mandatory for non-core aspects. helpful for core aspects in case of a name collision")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6843,7 +6868,7 @@ function MDXContent(_ref) {
   }, "-t")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "env-id of the template. alias for --env.")), (0, _react2.mdx)("tr", {
+  }, "env-id of the template's owner. Alias for --env.")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6856,7 +6881,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "env-id of the template")), (0, _react2.mdx)("tr", {
+  }, "env-id of the template. Alias -t")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6871,7 +6896,7 @@ function MDXContent(_ref) {
   }, "-d")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "set defaultScope in the new workspace.jsonc")), (0, _react2.mdx)("tr", {
+  }, "set defaultScope in the new workspace's workspace.jsonc")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6899,7 +6924,7 @@ function MDXContent(_ref) {
   }, "-s")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "skip generation of Git repository")), (0, _react2.mdx)("tr", {
+  }, "skip generation of Git repository in the new workspace")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6914,7 +6939,7 @@ function MDXContent(_ref) {
   }, "-e")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "empty workspace with no components (relevant for templates that add components by default)")), (0, _react2.mdx)("tr", {
+  }, "skip template's default component creation (relevant for templates that add components by default)")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -6927,7 +6952,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "path to the workspace containing the template. helpful during a development of a workspace-template")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "pattern"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "local path to the workspace containing the template. Helpful during a development of a workspace-template")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "pattern"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Description"), ": list the component ids matching the given pattern", (0, _react2.mdx)("br", {
     parentName: "p"
@@ -6937,7 +6962,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", "a pattern can be used with wildcards for multiple component ids, e.g. \"org.scope/utils/", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "\".", (0, _react2.mdx)("br", {
+  }, "\" or \""), "/utils/", (0, _react2.mdx)("strong", {
+    parentName: "p"
+  }, "\" to capture all org/scopes.", (0, _react2.mdx)("br", {
     parentName: "strong"
   }), "to enter multiple patterns, separate them by a comma, e.g. \"ui/", (0, _react2.mdx)("em", {
     parentName: "strong"
@@ -6947,7 +6974,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "the matching algorithm is done by multimatch (@see ", (0, _react2.mdx)("a", {
+  }), "\n", "the matching algorithm is from multimatch (@see ", (0, _react2.mdx)("a", {
     parentName: "p",
     "href": "https://github.com/sindresorhus/multimatch"
   }, "https://github.com/sindresorhus/multimatch"), ")"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
@@ -6990,7 +7017,7 @@ function MDXContent(_ref) {
     "align": null
   }, "return the output as JSON")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "recover"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": EXPERIMENTAL. recover soft-removed component(s) from the workspace, or a remote scope"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": EXPERIMENTAL. recover component(s) soft-deleted from the workspace, or a remote scope"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit recover <component-name>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -7046,12 +7073,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "<new-id>"), " arguments can be either a component-id or a package-name."), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "remote"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": manage set of tracked bit scope(s)", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", (0, _react2.mdx)("a", {
-    parentName: "p",
-    "href": "https://bit.dev/reference/scope/remote-scopes"
-  }, "https://bit.dev/reference/scope/remote-scopes")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": manage set of tracked bit scope(s)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit remote")), (0, _react2.mdx)("h3", null, "remote add"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -7141,7 +7163,7 @@ function MDXContent(_ref) {
   }, "-g")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "remove a global configured remote scope")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "remove a globally configured remote scope")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -7185,11 +7207,11 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": remove component(s) from the workspace, or a remote scope", (0, _react2.mdx)("br", {
+  }, "Description"), ": remove component(s) from the workspace, or a remote scope (with a flag)", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "to remove components from your local workspace only, use \"bit remove\" (with no flags)."), (0, _react2.mdx)("p", null, "to remove a component from the remote scope, use \"bit remove --delete\", to mark the components as deleted.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "once tagged/snapped and exported, the remote scope will be updated and it'll be marked as deleted there as well."), (0, _react2.mdx)("p", null, "to remove components from lanes, use \"bit lane remove-comp\"."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "once tagged/snapped and exported, the remote scope will be updated and it'll be marked as deleted there as well."), (0, _react2.mdx)("p", null, "to remove components from a lane, use \"bit lane remove-comp\"."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit remove <component-pattern>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -7324,7 +7346,7 @@ function MDXContent(_ref) {
     "align": null
   }, "skip confirmation")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "rename"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": rename component. if tagged/exported, create a new component and deprecate the original component"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": rename component. if tagged/exported, create a new component and deprecate the original component. otherwise just renames current component"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit rename <current-name> <new-name>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -7362,7 +7384,7 @@ function MDXContent(_ref) {
   }, "new-name")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "the new component name (without its scope name)")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "the new component name (without its scope name. use --scope to define the new component's scope)")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -7398,7 +7420,7 @@ function MDXContent(_ref) {
   }, "-s")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "default scope for the newly created component")), (0, _react2.mdx)("tr", {
+  }, "define the scope for the newly created component")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -7413,9 +7435,7 @@ function MDXContent(_ref) {
   }, "-p")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "relative path in the workspace. by default the path is ", (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "<scope>/<namespace>/<name>"))), (0, _react2.mdx)("tr", {
+  }, "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")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -7524,7 +7544,7 @@ function MDXContent(_ref) {
   }, "-a")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "revert tag/snap for all tagged/snapped components")), (0, _react2.mdx)("tr", {
+  }, "revert all unexported tags/snaps for all components")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -7565,7 +7585,7 @@ function MDXContent(_ref) {
   }, "-f")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "revert the tag even if used as a dependency. WARNING: components that depend on this tag will corrupt")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "revert"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "revert the tag even if it's used as a dependency. WARNING: components that depend on this tag will be corrupted")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "revert"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Description"), ": replace the current component files by the specified version, leave the version intact"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -7664,7 +7684,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": run an app (independent of bit's dev server)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": locally run an app component (independent of bit's dev server)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit run <app-name>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -7743,7 +7763,7 @@ function MDXContent(_ref) {
   }, "-p")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "port of the app")), (0, _react2.mdx)("tr", {
+  }, "port to run the app on")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -7758,7 +7778,7 @@ function MDXContent(_ref) {
   }, "-v")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "showing verbose output for inspection and prints stack trace")), (0, _react2.mdx)("tr", {
+  }, "show verbose output for inspection and print stack trace")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -7786,7 +7806,7 @@ function MDXContent(_ref) {
     "align": null
   }, "run app in server side rendering mode.")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "schema"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": shows the API schema of a certain component.", (0, _react2.mdx)("br", {
+  }, "Description"), ": shows the API schema of the specified component/s.", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "you can use a ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -7840,7 +7860,7 @@ function MDXContent(_ref) {
   }, "-j")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "return the component data in json format")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "scope"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "return the component schema in json format")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "scope"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Description"), ": manage the scope-name for components"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -7850,9 +7870,11 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "scope set <scope-name> [component-pattern]")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": Sets components with a default-scope. If no component is specified, sets the workspace with a default scope", (0, _react2.mdx)("br", {
+  }, "Description"), ": Sets the scope for specified component/s. If no component is specified, sets the default scope of the workspace", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "default scopes for components are set in the bitmap file. the default scope for a workspace is set in the workspace.jsonc.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "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.'"), (0, _react2.mdx)("p", null, "you can use a ", (0, _react2.mdx)("inlineCode", {
+  }), "\n", "a component is set with a scope (as oppose to default scope) only once it is versioned.'"), (0, _react2.mdx)("p", null, "you can use a ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "<pattern>"), " for multiple component ids, such as ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -7892,7 +7914,7 @@ function MDXContent(_ref) {
   }, "scope-name")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "the scope name to use as the default scope")), (0, _react2.mdx)("tr", {
+  }, "name of the scope to set")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -7908,7 +7930,17 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "scope rename <current-scope-name> <new-scope-name>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": Renames the scope name for all components with the specified 'current scope name'"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "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", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "Note: if ", (0, _react2.mdx)("inlineCode", {
+    parentName: "p"
+  }, "<current-scope-name>"), " is also the defaultScope for the workspace, this command will set ", (0, _react2.mdx)("inlineCode", {
+    parentName: "p"
+  }, "<new-scope-name>"), (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "as the defaultScope instead, and that will then be set for all components by default. You may see updates in your .bitmap file", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "as a result of this change"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -7980,7 +8012,7 @@ function MDXContent(_ref) {
   }, "-r")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "update the import statements in all dependent components to the new package name (that contains the new scope name)")))), (0, _react2.mdx)("h3", null, "scope rename-owner"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "update the import statements in all dependent components to the new package name (i.e. with the new scope name)")))), (0, _react2.mdx)("h3", null, "scope rename-owner"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -8064,7 +8096,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "scope fork <original-scope> <new-scope>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": fork all components of the original-scope and refactor the source-code to use the new package names"), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "scope-config"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "Description"), ": fork all components of the original-scope and refactor the source-code to use the new scope name"), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "scope-config"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Description"), ": scope config management"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -8198,7 +8230,7 @@ function MDXContent(_ref) {
   }, "-j")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "return the component data in a json format")), (0, _react2.mdx)("tr", {
+  }, "return the component data in json format")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -8228,7 +8260,7 @@ function MDXContent(_ref) {
   }, "-r")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show a remote component")), (0, _react2.mdx)("tr", {
+  }, "show data for a remote component")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -8243,9 +8275,9 @@ function MDXContent(_ref) {
   }, "-c")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "compare current file system component to the latest tagged component ", "[default=latest]", ". only works in legacy.")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "snap"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "legacy-only. compare current file system component to its latest tagged version ", "[default=latest]")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "snap"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": create an immutable and exportable component snapshot (no release version)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": create an immutable and exportable component snapshot (non-release version)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit snap [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -8273,7 +8305,7 @@ function MDXContent(_ref) {
   }, "component-pattern")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "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. By default, all new and modified components are snapped.")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "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. By default, only new and modified components are snapped (add --unmodified to snap all components in the workspace).")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -8309,7 +8341,7 @@ function MDXContent(_ref) {
   }, "-m")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "log message describing the latest changes")), (0, _react2.mdx)("tr", {
+  }, "snap message describing the latest changes - will appear in component history log")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -8350,7 +8382,7 @@ function MDXContent(_ref) {
   }, "-b")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "not needed for now. run the build pipeline in case the feature-flag build-on-ci is enabled")), (0, _react2.mdx)("tr", {
+  }, "not needed for now. run the build pipeline locally in case the feature-flag build-on-ci is enabled")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -8363,7 +8395,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "open an editor to write a tag message for each component. optionally, specify the editor-name (defaults to vim).")), (0, _react2.mdx)("tr", {
+  }, "open an editor to write a snap message per component. optionally specify the editor-name (defaults to vim).")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -8402,7 +8434,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "skip the snap pipeline")), (0, _react2.mdx)("tr", {
+  }, "skip the snap pipeline. this will for instance skip packing and publishing component version for install, and app deployment")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -8428,7 +8460,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "run the snap pipeline although the build pipeline failed")), (0, _react2.mdx)("tr", {
+  }, "proceed to snap pipeline even when build pipeline fails")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -8458,7 +8490,7 @@ function MDXContent(_ref) {
   }, "-a")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "DEPRECATED (not needed anymore, it is the default now). snap all new and modified components")), (0, _react2.mdx)("tr", {
+  }, "DEPRECATED (not needed anymore, now the default). snap all new and modified components")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -8471,7 +8503,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "stop pipeline execution on the first failed task (by default a task is skipped only when its dependent failed)")), (0, _react2.mdx)("tr", {
+  }, "stop pipeline execution on the first failed task (by default a task is skipped only when its dependency failed)")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -8588,7 +8620,7 @@ function MDXContent(_ref) {
   }, "-r")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "rebuild the UI")), (0, _react2.mdx)("tr", {
+  }, "rebuild the UI (useful e.g. when updating the workspace UI - can use the dev flag for HMR in this case)")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -8667,7 +8699,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": present the current status of components in the workspace, and notifies when issues are detected"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": present the current status of components in the workspace, including indication of detected issues"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit status")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -8718,7 +8750,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show extra data: full snap hashes for staged and divergence point for lanes")), (0, _react2.mdx)("tr", {
+  }, "show extra data: full snap hashes for staged components, and divergence point for lanes")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -8799,7 +8831,7 @@ function MDXContent(_ref) {
   }, "component-patterns...")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "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.")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "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. By default, all new and modified are tagged.")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -8975,7 +9007,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "tag components that their head is a snap (not a tag)")), (0, _react2.mdx)("tr", {
+  }, "tag only components whose head is a snap (not a tag)")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -9079,7 +9111,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "run the tag pipeline although the build pipeline failed")), (0, _react2.mdx)("tr", {
+  }, "proceed to tag pipeline even when build pipeline fails")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -9122,7 +9154,7 @@ function MDXContent(_ref) {
   }, "-I")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "ignore existing of newer versions (default = false)")), (0, _react2.mdx)("tr", {
+  }, "allow tagging even when the component has newer versions e.g. for hotfixes (default = false)")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -9135,7 +9167,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "stop pipeline execution on the first failed task (by default a task is skipped only when its dependent failed)")), (0, _react2.mdx)("tr", {
+  }, "stop pipeline execution on the first failed task (by default a task is skipped only when its dependency failed)")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -9180,7 +9212,7 @@ function MDXContent(_ref) {
   }, "-s")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "DEPRECATED (use \"--unmodified\" instead). tag all components of the current scope")), (0, _react2.mdx)("tr", {
+  }, "DEPRECATED (use \"--unmodified\" instead). tag all components of the local scope")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -9195,7 +9227,7 @@ function MDXContent(_ref) {
   }, "-f")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "DEPRECATED (use \"--skip-tests\" or \"--unmodified\" instead). force-tag even if tests are failing and even when component has not changed")), (0, _react2.mdx)("tr", {
+  }, "DEPRECATED (use \"--skip-tests\", \"--ignore-build-errors\" or \"--unmodified\" instead). force-tag even if tests are failing and even when component has not changed")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -9210,7 +9242,7 @@ function MDXContent(_ref) {
     "align": null
   }, "DEPRECATED. use --disable-tag-pipeline instead")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "templates"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list templates for \"bit create\" and \"bit new\"", (0, _react2.mdx)("br", {
+  }, "Description"), ": list available templates for \"bit create\" and \"bit new\"", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "list components templates when inside bit-workspace (for bit-create), otherwise, list workspace templates (for bit-new)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -9273,7 +9305,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": test components in the workspace"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": test components in the workspace. by default only runs tests for new and modified components"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit test [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -9408,7 +9440,7 @@ function MDXContent(_ref) {
   }, "-e")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "test only the given env")), (0, _react2.mdx)("tr", {
+  }, "test only components assigned the given env")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -9473,7 +9505,9 @@ function MDXContent(_ref) {
   }, "package-patterns...")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
-  }, "a list of package names, or patterns (separated by space). The patterns should be in glob format. By default, all packages are selected.")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "a string list of package names, or patterns (separated by space), e.g. \"@teambit/", (0, _react2.mdx)("strong", {
+    parentName: "td"
+  }, " @my-org/ui/"), "\". The patterns should be in glob format. By default, all packages are selected.")))), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -9509,7 +9543,7 @@ function MDXContent(_ref) {
   }, "-y")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "automatically update all outdated packages")), (0, _react2.mdx)("tr", {
+  }, "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")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -9580,7 +9614,13 @@ function MDXContent(_ref) {
     "align": "center"
   }, "the component ID of the aspect")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "watch"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": automatically recompile modified components (on save)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": automatically recompile modified components (on save)", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "by default, the watcher doesn't use polling, to keep the CPU idle.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "in some rare cases, this could result in missing file events. to fix it, try to prefix this command with CHOKIDAR_USEPOLLING=true", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "alternatively, restarting the computer could also help."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit watch")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -9618,7 +9658,7 @@ function MDXContent(_ref) {
   }, "-v")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show npm verbose output for inspection and print the stack trace")), (0, _react2.mdx)("tr", {
+  }, "show all watch events and compiler verbose output")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -9631,7 +9671,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "skip the compilation step before starting to watch")), (0, _react2.mdx)("tr", {
+  }, "skip compilation step before starting to watch")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -9767,7 +9807,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "use with --json flag. show the config content and the paths it will be written per env")), (0, _react2.mdx)("tr", {
+  }, "use with --json flag. show the config content and the paths that will be written per env")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -9854,7 +9894,7 @@ function MDXContent(_ref) {
   }, "-w")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "only write config files for the given writers. use comma to separate multiple writers. use ws-config list to see all writers")), (0, _react2.mdx)("tr", {
+  }, "only clean config files for the given writers. use comma to separate multiple writers. use ws-config list to see all writers")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -9867,7 +9907,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "show the paths that configs will be written per env")), (0, _react2.mdx)("tr", {
+  }, "show the paths of configs that will be cleaned")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",