diff --git a/docs/generate.md b/docs/generate.md
new file mode 100644
index 000000000..1544798d5
--- /dev/null
+++ b/docs/generate.md
@@ -0,0 +1,67 @@
+# `oclif generate`
+
+generate a new CLI
+This will clone the template repo 'oclif/hello-world' and update package properties
+
+- [`oclif generate NAME`](#oclif-generate-name)
+- [`oclif generate command NAME`](#oclif-generate-command-name)
+- [`oclif generate hook NAME`](#oclif-generate-hook-name)
+
+## `oclif generate NAME`
+
+generate a new CLI
+
+```
+USAGE
+  $ oclif generate NAME
+
+ARGUMENTS
+  NAME  directory name of new project
+
+DESCRIPTION
+  generate a new CLI
+  This will clone the template repo 'oclif/hello-world' and update package properties
+```
+
+_See code: [src/commands/generate.ts](https://github.com/oclif/oclif/blob/v4.5.2/src/commands/generate.ts)_
+
+## `oclif generate command NAME`
+
+add a command to an existing CLI or plugin
+
+```
+USAGE
+  $ oclif generate command NAME [--force]
+
+ARGUMENTS
+  NAME  name of command
+
+FLAGS
+  --force  overwrite existing files
+
+DESCRIPTION
+  add a command to an existing CLI or plugin
+```
+
+_See code: [src/commands/generate/command.ts](https://github.com/oclif/oclif/blob/v4.5.2/src/commands/generate/command.ts)_
+
+## `oclif generate hook NAME`
+
+add a hook to an existing CLI or plugin
+
+```
+USAGE
+  $ oclif generate hook NAME [--event <value>] [--force]
+
+ARGUMENTS
+  NAME  name of hook (snake_case)
+
+FLAGS
+  --event=<value>  [default: init] event to run hook on
+  --force          overwrite existing files
+
+DESCRIPTION
+  add a hook to an existing CLI or plugin
+```
+
+_See code: [src/commands/generate/hook.ts](https://github.com/oclif/oclif/blob/v4.5.2/src/commands/generate/hook.ts)_
diff --git a/docs/help.md b/docs/help.md
new file mode 100644
index 000000000..e6ae20561
--- /dev/null
+++ b/docs/help.md
@@ -0,0 +1,25 @@
+# `oclif help`
+
+Display help for oclif.
+
+- [`oclif help [COMMANDS]`](#oclif-help-commands)
+
+## `oclif help [COMMANDS]`
+
+Display help for oclif.
+
+```
+USAGE
+  $ oclif help [COMMANDS] [-n]
+
+ARGUMENTS
+  COMMANDS  Command to show help for.
+
+FLAGS
+  -n, --nested-commands  Include all nested commands in the output.
+
+DESCRIPTION
+  Display help for oclif.
+```
+
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.0.14/src/commands/help.ts)_
diff --git a/docs/manifest.md b/docs/manifest.md
new file mode 100644
index 000000000..36e5a571f
--- /dev/null
+++ b/docs/manifest.md
@@ -0,0 +1,25 @@
+# `oclif manifest`
+
+generates plugin manifest json
+
+- [`oclif manifest [PATH]`](#oclif-manifest-path)
+
+## `oclif manifest [PATH]`
+
+generates plugin manifest json
+
+```
+USAGE
+  $ oclif manifest [PATH] [--jit]
+
+ARGUMENTS
+  PATH  [default: .] path to plugin
+
+FLAGS
+  --[no-]jit  append commands from JIT plugins in manifest
+
+DESCRIPTION
+  generates plugin manifest json
+```
+
+_See code: [src/commands/manifest.ts](https://github.com/oclif/oclif/blob/v4.5.2/src/commands/manifest.ts)_
diff --git a/docs/pack.md b/docs/pack.md
new file mode 100644
index 000000000..7b0c40876
--- /dev/null
+++ b/docs/pack.md
@@ -0,0 +1,109 @@
+# `oclif pack`
+
+package an oclif CLI into installable artifacts
+
+- [`oclif pack deb`](#oclif-pack-deb)
+- [`oclif pack macos`](#oclif-pack-macos)
+- [`oclif pack tarballs`](#oclif-pack-tarballs)
+- [`oclif pack win`](#oclif-pack-win)
+
+## `oclif pack deb`
+
+Pack CLI into debian package.
+
+```
+USAGE
+  $ oclif pack deb -r <value> [-z gzip|none|xz|zstd] [-t <value>]
+
+FLAGS
+  -r, --root=<value>          (required) [default: .] Path to oclif CLI root.
+  -t, --tarball=<value>       Optionally specify a path to a tarball already generated by NPM.
+  -z, --compression=<option>  Override the default compression used by dpkg-deb.
+                              <options: gzip|none|xz|zstd>
+
+DESCRIPTION
+  Pack CLI into debian package.
+
+FLAG DESCRIPTIONS
+  -z, --compression=gzip|none|xz|zstd  Override the default compression used by dpkg-deb.
+
+    For more details see the `-Zcompress-type` section at https://man7.org/linux/man-pages/man1/dpkg-deb.1.html
+```
+
+_See code: [src/commands/pack/deb.ts](https://github.com/oclif/oclif/blob/v4.5.2/src/commands/pack/deb.ts)_
+
+## `oclif pack macos`
+
+pack CLI into macOS .pkg
+
+```
+USAGE
+  $ oclif pack macos -r <value> [-t <value>] [--targets <value>]
+
+FLAGS
+  -r, --root=<value>     (required) [default: .] path to oclif CLI root
+  -t, --tarball=<value>  optionally specify a path to a tarball already generated by NPM
+      --targets=<value>  comma-separated targets to pack (e.g.: darwin-x64,darwin-arm64)
+
+DESCRIPTION
+  pack CLI into macOS .pkg
+```
+
+_See code: [src/commands/pack/macos.ts](https://github.com/oclif/oclif/blob/v4.5.2/src/commands/pack/macos.ts)_
+
+## `oclif pack tarballs`
+
+packages oclif CLI into tarballs
+
+```
+USAGE
+  $ oclif pack tarballs -r <value> [--parallel] [-l <value>] [-t <value>] [--xz]
+
+FLAGS
+  -l, --tarball=<value>  optionally specify a path to a tarball already generated by NPM
+  -r, --root=<value>     (required) [default: .] path to oclif CLI root
+  -t, --targets=<value>  comma-separated targets to pack (e.g.: linux-arm,win32-x64)
+      --parallel         build tarballs in parallel
+      --[no-]xz          also build xz
+
+DESCRIPTION
+  packages oclif CLI into tarballs
+
+  This can be used to create oclif CLIs that use the system node or that come preloaded with a node binary.
+```
+
+_See code: [src/commands/pack/tarballs.ts](https://github.com/oclif/oclif/blob/v4.5.2/src/commands/pack/tarballs.ts)_
+
+## `oclif pack win`
+
+create windows installer from oclif CLI
+
+```
+USAGE
+  $ oclif pack win -r <value> [--defender-exclusion checked|unchecked|hidden] [-t <value>] [--targets <value>]
+
+FLAGS
+  -r, --root=<value>                 (required) [default: .] path to oclif CLI root
+  -t, --tarball=<value>              optionally specify a path to a tarball already generated by NPM
+      --defender-exclusion=<option>  [default: checked] set to "checked" or "unchecked" to set the default value for the
+                                     checkbox.  Set to "hidden" to hide the option (will let defender do its thing)
+                                     <options: checked|unchecked|hidden>
+      --targets=<value>              comma-separated targets to pack (e.g.: win32-x64,win32-x86)
+
+DESCRIPTION
+  create windows installer from oclif CLI
+
+  This command will produce unsigned installers unless you supply WINDOWS_SIGNING_PASS (prefixed with the name of your
+  executable, e.g. OCLIF_WINDOWS_SIGNING_PASS) in the environment and have set the windows.name and windows.keypath
+  properties in your package.json's oclif property.
+
+FLAG DESCRIPTIONS
+  --defender-exclusion=checked|unchecked|hidden
+
+    set to "checked" or "unchecked" to set the default value for the checkbox.  Set to "hidden" to hide the option (will
+    let defender do its thing)
+
+    there is no way to set a hidden checkbox with "true" as a default...the user can always allow full security
+```
+
+_See code: [src/commands/pack/win.ts](https://github.com/oclif/oclif/blob/v4.5.2/src/commands/pack/win.ts)_
diff --git a/docs/promote.md b/docs/promote.md
new file mode 100644
index 000000000..ebb4215d7
--- /dev/null
+++ b/docs/promote.md
@@ -0,0 +1,33 @@
+# `oclif promote`
+
+promote CLI builds to a S3 release channel
+
+- [`oclif promote`](#oclif-promote)
+
+## `oclif promote`
+
+promote CLI builds to a S3 release channel
+
+```
+USAGE
+  $ oclif promote --channel <value> -r <value> --sha <value> --version <value> [-d] [--indexes] [-m] [-a
+    <value>] [-t <value>] [-w] [--xz]
+
+FLAGS
+  -a, --max-age=<value>  [default: 86400] cache control max-age in seconds
+  -d, --deb              promote debian artifacts
+  -m, --macos            promote macOS pkg
+  -r, --root=<value>     (required) [default: .] path to the oclif CLI project root
+  -t, --targets=<value>  comma-separated targets to promote (e.g.: linux-arm,win32-x64)
+  -w, --win              promote Windows exe
+      --channel=<value>  (required) [default: stable] which channel to promote to
+      --indexes          append the promoted urls into the index files
+      --sha=<value>      (required) 7-digit short git commit SHA of the CLI to promote
+      --version=<value>  (required) semantic version of the CLI to promote
+      --[no-]xz          also upload xz
+
+DESCRIPTION
+  promote CLI builds to a S3 release channel
+```
+
+_See code: [src/commands/promote.ts](https://github.com/oclif/oclif/blob/v4.5.2/src/commands/promote.ts)_
diff --git a/docs/readme.md b/docs/readme.md
new file mode 100644
index 000000000..0fbe05401
--- /dev/null
+++ b/docs/readme.md
@@ -0,0 +1,54 @@
+# `oclif readme`
+
+adds commands to README.md in current directory
+The readme must have any of the following tags inside of it for it to be replaced or else it will do nothing:
+
+# Usage
+
+<!-- usage -->
+
+# Commands
+
+<!-- commands -->
+
+# Table of contents
+
+<!-- toc -->
+
+Customize the code URL prefix by setting oclif.repositoryPrefix in package.json.
+
+- [`oclif readme`](#oclif-readme)
+
+## `oclif readme`
+
+adds commands to README.md in current directory
+
+```
+USAGE
+  $ oclif readme --output-dir <value> ---path <value> [--aliases] [--nested-topics-depth <value> --multi]
+    [--plugin-directory <value>] [--repository-prefix <value>] [--version <value>]
+
+FLAGS
+  --[no-]aliases                 Include aliases in the command list.
+  --multi                        Create a different markdown page for each topic.
+  --nested-topics-depth=<value>  Max nested topics depth for multi markdown page generation. Use with --multi enabled.
+  --output-dir=<value>           (required) [default: docs] Output directory for multi docs.
+  --plugin-directory=<value>     Plugin directory to generate README for. Defaults to the current directory.
+  --readme-path=<value>          (required) [default: README.md] Path to the README file.
+  --repository-prefix=<value>    A template string used to build links to the source code.
+  --version=<value>              Version to use in readme links. Defaults to the version in package.json.
+
+DESCRIPTION
+  adds commands to README.md in current directory
+  The readme must have any of the following tags inside of it for it to be replaced or else it will do nothing:
+  # Usage
+  <!-- usage -->
+  # Commands
+  <!-- commands -->
+  # Table of contents
+  <!-- toc -->
+
+  Customize the code URL prefix by setting oclif.repositoryPrefix in package.json.
+```
+
+_See code: [src/commands/readme.ts](https://github.com/oclif/oclif/blob/v4.5.2/src/commands/readme.ts)_
diff --git a/docs/upload.md b/docs/upload.md
new file mode 100644
index 000000000..db04215a3
--- /dev/null
+++ b/docs/upload.md
@@ -0,0 +1,82 @@
+# `oclif upload`
+
+upload installable CLI artifacts to AWS S3
+
+- [`oclif upload deb`](#oclif-upload-deb)
+- [`oclif upload macos`](#oclif-upload-macos)
+- [`oclif upload tarballs`](#oclif-upload-tarballs)
+- [`oclif upload win`](#oclif-upload-win)
+
+## `oclif upload deb`
+
+upload deb package built with pack:deb
+
+```
+USAGE
+  $ oclif upload deb -r <value>
+
+FLAGS
+  -r, --root=<value>  (required) [default: .] path to oclif CLI root
+
+DESCRIPTION
+  upload deb package built with pack:deb
+```
+
+_See code: [src/commands/upload/deb.ts](https://github.com/oclif/oclif/blob/v4.5.2/src/commands/upload/deb.ts)_
+
+## `oclif upload macos`
+
+upload macos installers built with pack:macos
+
+```
+USAGE
+  $ oclif upload macos -r <value> [-t <value>]
+
+FLAGS
+  -r, --root=<value>     (required) [default: .] path to oclif CLI root
+  -t, --targets=<value>  comma-separated targets to upload (e.g.: darwin-x64,darwin-arm64)
+
+DESCRIPTION
+  upload macos installers built with pack:macos
+```
+
+_See code: [src/commands/upload/macos.ts](https://github.com/oclif/oclif/blob/v4.5.2/src/commands/upload/macos.ts)_
+
+## `oclif upload tarballs`
+
+upload an oclif CLI to S3
+
+```
+USAGE
+  $ oclif upload tarballs -r <value> [-t <value>] [--xz]
+
+FLAGS
+  -r, --root=<value>     (required) [default: .] path to oclif CLI root
+  -t, --targets=<value>  comma-separated targets to upload (e.g.: linux-arm,win32-x64)
+      --[no-]xz          also upload xz
+
+DESCRIPTION
+  upload an oclif CLI to S3
+
+  "aws-sdk" will need to be installed as a devDependency to upload.
+```
+
+_See code: [src/commands/upload/tarballs.ts](https://github.com/oclif/oclif/blob/v4.5.2/src/commands/upload/tarballs.ts)_
+
+## `oclif upload win`
+
+upload windows installers built with pack:win
+
+```
+USAGE
+  $ oclif upload win -r <value> [--targets <value>]
+
+FLAGS
+  -r, --root=<value>     (required) [default: .] path to oclif CLI root
+      --targets=<value>  comma-separated targets to pack (e.g.: win32-x64,win32-x86)
+
+DESCRIPTION
+  upload windows installers built with pack:win
+```
+
+_See code: [src/commands/upload/win.ts](https://github.com/oclif/oclif/blob/v4.5.2/src/commands/upload/win.ts)_
diff --git a/package.json b/package.json
index 5a07817bc..cbba27f31 100644
--- a/package.json
+++ b/package.json
@@ -127,7 +127,7 @@
     "lint": "eslint . --ext .ts",
     "postpack": "shx rm oclif.manifest.json",
     "posttest": "yarn run lint",
-    "prepack": "shx rm -rf lib && tsc && bin/run.js manifest .",
+    "prepack": "yarn build && bin/run.js manifest && bin/run.js readme --multi",
     "prepare": "husky",
     "test:integration:cli": "mocha test/integration/cli.test.ts --timeout 600000",
     "test:integration:deb": "mocha test/integration/deb.test.ts --timeout 900000",