docs: Add pack docs.

src/commands/Watch.tsx

@@ -49,7 +49,8 @@ export class WatchCommand extends Command<GlobalOptions> {
     this.log('Watching for changes...');
   }
 
-  enqueueRebuild = (event: string, path: string) => {
+  @Bind()
+  enqueueRebuild(event: string, path: string) {
     if (event !== 'add' && event !== 'change' && event !== 'unlink') {
       return;
     }
@@ -62,7 +63,7 @@ export class WatchCommand extends Command<GlobalOptions> {
       this.packagesToRebuild.add(changedPkg);
       this.triggerRebuilds();
     }
-  };
+  }
 
   triggerRebuilds() {
     if (this.rebuildTimer) {
@@ -74,7 +75,6 @@ export class WatchCommand extends Command<GlobalOptions> {
     }, this.debounce);
   }
 
-  @Bind()
   async rebuildPackages() {
     if (this.rebuilding) {
       this.triggerRebuilds();

website/docs/build.md

@@ -1,5 +1,5 @@
 ---
-title: Building packages
+title: Build
 sidebar_label: build
 ---
 
@@ -14,16 +14,11 @@ to their configured build targets (platform, formats, etc).
 ```json title="package.json"
 {
   "scripts": {
-    "build:internal": "packemon build --addEngines --generateDeclaration=api",
-    "build": "NODE_ENV=production yarn run build:internal",
-    "release": "yarn run build && yarn publish"
+    "build": "packemon build --addEngines"
   }
 }
 ```
 
-> When publishing, be sure to set `NODE_ENV` to production to remove all development and testing
-> configuration settings.
-
 ## Options
 
 Build supports the following command line options.
@@ -44,7 +39,7 @@ Build supports the following command line options.
   - `standard` - Generates multiple `d.ts` files with `tsc`.
   - `api` - Generates a single `d.ts` file for each input. Uses
     [@microsoft/api-extractor](https://www.npmjs.com/package/@microsoft/api-extractor) to _only_
-    generate the public API. (NOTE: this is quite slow)
+    generate the public API. _(NOTE: this is quite slow)_
 - `--skipPrivate` - Skip `private` packages from being built.
 - `--timeout` - Timeout in milliseconds before a build is cancelled. Defaults to no timeout.
 

website/docs/clean.md

@@ -1,5 +1,5 @@
 ---
-title: Cleaning packages
+title: Clean
 sidebar_label: clean
 ---
 

website/docs/pack.md

@@ -0,0 +1,28 @@
+---
+title: Pack
+sidebar_label: pack
+---
+
+The `pack` command is a multi-step pre-release solution for preparing packages for distribution.
+When ran, it begins by [cleaning workspaces](./clean.md), then [building all packages](./build.md),
+and finally [validating all packages](./validate.md) before a release.
+
+If any of the steps fail, a non-zero exit code will be triggered, allowing the release cycle to be
+aborted.
+
+```json title="package.json"
+{
+  "scripts": {
+    "pack": "NODE_ENV=production packemon pack --addEngines --generateDeclaration=api",
+    "release": "yarn run pack && yarn publish"
+  }
+}
+```
+
+> When releasing, be sure to set `NODE_ENV` to production to remove all development and testing
+> configuration settings.
+
+## Options
+
+Pack supports all the same command line options as [`build`](./build.md). The validation step cannot
+be customized and will vaidate _everything_ by default.

website/docs/validate.md

@@ -1,5 +1,5 @@
 ---
-title: Validating packages
+title: Validate
 sidebar_label: validate
 ---
 
@@ -14,7 +14,6 @@ pre-publish step. It accomplishes this by inspecting each package's `package.jso
 ```json title="package.json"
 {
   "scripts": {
-    "release": "yarn run build && yarn run validate && yarn publish",
     "validate": "packemon validate"
   }
 }

website/sidebars.js

@@ -10,7 +10,7 @@ module.exports = {
       type: 'category',
       label: 'Commands',
       collapsed: false,
-      items: ['build', 'clean', 'validate', 'watch'],
+      items: ['build', 'clean', 'pack', 'validate', 'watch'],
     },
     'advanced',
     {