@teambit/harmony.content.cli-reference 1.95.30 → 1.95.33

package/dist/cli-reference.mdx.js

@@ -119,7 +119,7 @@ function MDXContent(_ref) {
   }, "-t")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "specify test files to track. use quotation marks to list files or use a glob pattern")), (0, _react2.mdx)("tr", {
+  }, "LEGACY ONLY. specify test files to track. use quotation marks to list files or use a glob pattern")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -149,7 +149,7 @@ function MDXContent(_ref) {
   }, "-e")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "exclude file from being tracked. use quotation marks to list files or use a glob pattern")), (0, _react2.mdx)("tr", {
+  }, "LEGACY ONLY. exclude file from being tracked. use quotation marks to list files or use a glob pattern")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -330,19 +330,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "aspect list [pattern]")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list all aspects configured on component(s)", (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", {
-    parentName: "p"
-  }, "bit aspect list \"org.scope/utils/**\""), ". use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "to validate the pattern before running this command, run ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit pattern <pattern>"), "."), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": list all aspects configured on component(s)"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -382,9 +370,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "aspect get <component-id>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "aspect get <component-name>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": show aspects' data and configuration of the given component"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": list the aspects set on a component, as well as their config and data"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -441,70 +429,19 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "aspect set <pattern> <aspect-id> [config]")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": set an aspect to component(s) with optional config.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "enter the config as stringified JSON (e.g. '{\"foo\":\"bar\"}' ).", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "if no config entered, the aspect will be set with empty config ({}).", (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", {
-    parentName: "p"
-  }, "bit aspect set \"org.scope/utils/**\""), ". use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "to validate the pattern before running this command, run ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit pattern <pattern>"), "."), (0, _react2.mdx)("h3", null, "aspect unset"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "Description"), ": set components with an aspect to extend their development tools, metadata and (possibly) artifacts"), (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"
   }, "aspect unset <pattern> <aspect-id>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": unset an aspect from component(s).", (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", {
-    parentName: "p"
-  }, "bit aspect unset \"org.scope/utils/**\""), ". use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "to validate the pattern before running this command, run ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit pattern <pattern>"), "."), (0, _react2.mdx)("h3", null, "aspect update"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "Description"), ": unset an aspect from component(s)."), (0, _react2.mdx)("h3", null, "aspect update"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     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)("br", {
-    parentName: "p"
-  }), "\n", "default to all components using the aspect, unless \"pattern\" is provided.", (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", {
-    parentName: "p"
-  }, "bit aspect update <aspect-id> \"org.scope/utils/**\""), ". use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "to validate the pattern before running this command, run ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit pattern <pattern>"), "."), (0, _react2.mdx)("p", null, "examples:", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "\"bit aspect update scope.org/aspect '", (0, _react2.mdx)("strong", {
-    parentName: "p"
-  }, "/ui/"), "'\" - update \"ui\" components that use scope.org/aspect to the latest version", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "\"bit aspect update scope.org/", (0, _react2.mdx)("a", {
-    parentName: "p",
-    "href": "mailto:aspect@2.0.0"
-  }, "aspect@2.0.0"), "\" - updates all components using scope.org/aspect to version 2.0.0."), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "build"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "Description"), ": update a version of an aspect"), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "build"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Workspace only"), ": yes", (0, _react2.mdx)("br", {
     parentName: "p"
@@ -512,7 +449,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Description"), ": run set of tasks for build"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit build [pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit build [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -647,7 +584,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Description"), ": manage capsules", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "a capsule is a directory contains the component code, isolated from the workspace.", (0, _react2.mdx)("br", {
+  }), "\n", "a capsule is a directory containing the component code, isolated from the workspace.", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "normally, capsules are created during the build process, the component files are copied and the packages are installed", (0, _react2.mdx)("br", {
     parentName: "p"
@@ -661,7 +598,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "capsule list")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list all capsules"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": list the capsules generated for this workspace"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -701,9 +638,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "capsule create [componentIds...]")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "capsule create [component-id...]")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": create capsules"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": create capsules for components"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -909,7 +846,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Description"), ": check typescript types"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit check-types [pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit check-types [component-pattern]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -1695,7 +1632,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": show diff between components files", (0, _react2.mdx)("br", {
+  }, "Description"), ": show the diff between the components' source files and config", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "bit diff => compare all modified components to their model version", (0, _react2.mdx)("br", {
     parentName: "p"
@@ -1842,21 +1779,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": replaces the components from the local scope with the corresponding packages", (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", {
-    parentName: "p"
-  }, "bit eject \"org.scope/utils/**\""), ". use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "to validate the pattern before running this command, run ", (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": replace components maintained in the workspace with their corresponding packages"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit pattern <pattern>"), "."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit eject <pattern>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit eject <component-pattern>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -1934,13 +1859,17 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "<pattern>"), " for multiple component ids, such as ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit eject-conf \"org.scope/utils/**\""), ". use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
+  }, "bit eject-conf \"org.scope/utils/**\""), ".", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "to validate the pattern before running this command, run ", (0, _react2.mdx)("inlineCode", {
+  }), "\n", "use ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit pattern <pattern>"), "."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "bit pattern --help"), " to understand patterns better and ", (0, _react2.mdx)("inlineCode", {
+    parentName: "p"
+  }, "bit pattern <pattern>"), " to validate the pattern."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit eject-conf <pattern>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -2043,13 +1972,17 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "<pattern>"), " for multiple component ids, such as ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit env unset \"org.scope/utils/**\""), ". use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
+  }, "bit env unset \"org.scope/utils/**\""), ".", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "to validate the pattern before running this command, run ", (0, _react2.mdx)("inlineCode", {
+  }), "\n", "use ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit pattern <pattern>"), "."), (0, _react2.mdx)("h3", null, "envs replace"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "bit pattern --help"), " to understand patterns better and ", (0, _react2.mdx)("inlineCode", {
+    parentName: "p"
+  }, "bit pattern <pattern>"), " to validate the pattern."), (0, _react2.mdx)("h3", null, "envs replace"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -2217,7 +2150,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "HARMONY ONLY. avoid export to the central hub, instead, export directly to the original scopes. not recommended!")), (0, _react2.mdx)("tr", {
+  }, "EXPERIMENTAL. avoid export to the central hub, instead, export directly to the original scopes. not recommended!")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -3114,14 +3047,14 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": link components and core aspects", (0, _react2.mdx)("br", {
+  }, "Description"), ": create links in the node_modules directory, to core aspects and to components in the workspace", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("a", {
     parentName: "p",
     "href": "https://bit.dev/docs/workspace/component-links"
   }, "https://bit.dev/docs/workspace/component-links")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit link [ids...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit link [component-names...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -3375,36 +3308,6 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--bare")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "-b")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "DEPRECATED. use --raw instead")), (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "--raw")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": "center"
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
-  }, "-r")), (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, "show raw output (only components ids, no styling)")), (0, _react2.mdx)("tr", {
-    parentName: "tbody"
-  }, (0, _react2.mdx)("td", {
-    parentName: "tr",
-    "align": null
-  }, (0, _react2.mdx)("inlineCode", {
-    parentName: "td"
   }, "--outdated")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
@@ -3526,7 +3429,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": log the CLI into Bit Cloud"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": log in to Bit cloud"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit login")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -3610,7 +3513,7 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--machine-name <string>")), (0, _react2.mdx)("td", {
+  }, "--machine-name <name>")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
   }), (0, _react2.mdx)("td", {
@@ -3792,7 +3695,7 @@ function MDXContent(_ref) {
     "href": "https://bit.dev/docs/workspace/moving-components"
   }, "https://bit.dev/docs/workspace/moving-components")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit move <existing-dir> <new-dir>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit move <current-component-dir> <new-component-dir>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -3828,7 +3731,7 @@ function MDXContent(_ref) {
   }, "-c")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "move component files that are spread over multiple directories to one directory. synopsis: ", (0, _react2.mdx)("inlineCode", {
+  }, "LEGACY ONLY. move component files that are spread over multiple directories to one directory. synopsis: ", (0, _react2.mdx)("inlineCode", {
     parentName: "td"
   }, "move <component-id> <directory>"))))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "new"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -4055,7 +3958,28 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list the component ids matching the given pattern"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": list the component ids matching the given pattern", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "this command helps validating a pattern before using it in other commands.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "a pattern can be a simple component-id or component-name. e.g. \"ui/button\".", (0, _react2.mdx)("br", {
+    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", {
+    parentName: "strong"
+  }), "to enter multiple patterns, separate them by a comma, e.g. \"ui/", (0, _react2.mdx)("em", {
+    parentName: "strong"
+  }, ", lib/"), "\"", (0, _react2.mdx)("br", {
+    parentName: "strong"
+  }), "to exclude, use \"!\". e.g. \"ui/"), ", !ui/button\"", (0, _react2.mdx)("br", {
+    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", {
+    parentName: "p",
+    "href": "https://github.com/sindresorhus/multimatch"
+  }, "https://github.com/sindresorhus/multimatch"), ")"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit pattern <pattern>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -4262,7 +4186,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": remove component(s) from your workspace, or a remote scope", (0, _react2.mdx)("br", {
+  }, "Description"), ": remove component(s) from the workspace, or a remote scope", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("a", {
     parentName: "p",
@@ -4271,7 +4195,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", "you can use a pattern for multiple ids, such as bit remove \"utils/", "*", "\". (wrap the pattern with quotes to avoid collision with shell commands)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit remove <ids...>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit remove <component-ids...>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -4322,7 +4246,7 @@ function MDXContent(_ref) {
   }, "-t")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "keep tracking component (default = false)")), (0, _react2.mdx)("tr", {
+  }, "keep tracking component in .bitmap (default = false), helps transform a tagged-component to new")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4386,15 +4310,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": EXPERIMENTAL. rename component. if tagged/exported, create a new component and deprecate the source-component", (0, _react2.mdx)("br", {
+  }, "Description"), ": EXPERIMENTAL. rename component. if tagged/exported, create a new component and deprecate the original component"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }), "\n", "the ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "<target-name>"), " should include the component-name only, without the scope-name.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "to assign a default-scope to this component, please use \"--scope\" flag"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit rename <source-name> <target-name>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit rename <current-name> <new-name>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -4422,7 +4340,7 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--scope <string>")), (0, _react2.mdx)("td", {
+  }, "--scope <scope-name>")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
   }, (0, _react2.mdx)("inlineCode", {
@@ -4437,7 +4355,7 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--path <string>")), (0, _react2.mdx)("td", {
+  }, "--path <relative-path>")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
   }, (0, _react2.mdx)("inlineCode", {
@@ -4462,7 +4380,7 @@ function MDXContent(_ref) {
   }, "-r")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "change the source code of all components using this component with the new package-name")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "run"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "update the import/require statements in all dependent components (in the same workspace)")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "run"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Alias"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -4552,13 +4470,17 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "<pattern>"), " for multiple component ids, such as ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit schema \"org.scope/utils/**\""), ". use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
+  }, "bit schema \"org.scope/utils/**\""), ".", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "to validate the pattern before running this command, run ", (0, _react2.mdx)("inlineCode", {
+  }), "\n", "use ", (0, _react2.mdx)("inlineCode", {
+    parentName: "p"
+  }, "bit pattern --help"), " to understand patterns better and ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit pattern <pattern>"), "."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "bit pattern <pattern>"), " to validate the pattern."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit schema <pattern>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -4616,13 +4538,17 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "<pattern>"), " for multiple component ids, such as ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit scope set scope-name \"org.scope/utils/**\""), ". use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
+  }, "bit scope set scope-name \"org.scope/utils/**\""), ".", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "to validate the pattern before running this command, run ", (0, _react2.mdx)("inlineCode", {
+  }), "\n", "use ", (0, _react2.mdx)("inlineCode", {
+    parentName: "p"
+  }, "bit pattern --help"), " to understand patterns better and ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit pattern <pattern>"), "."), (0, _react2.mdx)("h3", null, "scope rename"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "bit pattern <pattern>"), " to validate the pattern."), (0, _react2.mdx)("h3", null, "scope rename"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -4989,9 +4915,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Description"), ": create an immutable and exportable component snapshot, tagged with a release version.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "if no ids are provided, it will tag all new and modified components.", (0, _react2.mdx)("br", {
+  }), "\n", "if no patterns are provided, it will tag all new and modified components.", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "if component ids are entered, you can specify a version per id using \"@\" sign, e.g. bit tag ", (0, _react2.mdx)("a", {
+  }), "\n", "if patterns are entered, you can specify a version per pattern using \"@\" sign, e.g. bit tag ", (0, _react2.mdx)("a", {
     parentName: "p",
     "href": "mailto:foo@1.0.0"
   }, "foo@1.0.0"), " bar@minor baz@major", (0, _react2.mdx)("br", {
@@ -4999,11 +4925,9 @@ function MDXContent(_ref) {
   }), "\n", (0, _react2.mdx)("a", {
     parentName: "p",
     "href": "https://bit.dev/components/tags"
-  }, "https://bit.dev/components/tags"), (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "you can use a pattern for multiple ids, such as bit tag \"utils/", "*", "\". (wrap the pattern with quotes to avoid collision with shell commands)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "https://bit.dev/components/tags")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit tag [component-names...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit tag [component-patterns...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -5485,7 +5409,7 @@ function MDXContent(_ref) {
   }, "-s")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "name of the scope to test")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "ui-build"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "DEPRECATED. (use the pattern instead, e.g. \"scopeName/", "*", "*", "\"). name of the scope to test")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "ui-build"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Alias"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -5527,7 +5451,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": revert versions tagged for component(s)", (0, _react2.mdx)("br", {
+  }, "Description"), ": revert tagged or snapped versions for component(s)", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("a", {
     parentName: "p",
@@ -5536,7 +5460,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", "you can use a pattern for multiple ids, such as bit untag \"utils/", "*", "\". (wrap the pattern with quotes to avoid collision with shell commands)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit untag [id] [version]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit untag [component-name] [component-version]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -5664,7 +5588,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": watch a set of components"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": automatically recompile modified components (on save)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit watch")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -5702,7 +5626,7 @@ function MDXContent(_ref) {
   }, "-v")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "showing npm verbose output for inspection and prints stack trace")), (0, _react2.mdx)("tr", {
+  }, "show npm verbose output for inspection and print the stack trace")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",