diff --git a/README.md b/README.md
index 35fc8f9..e7672d1 100644
--- a/README.md
+++ b/README.md
@@ -52,7 +52,7 @@ These packages contains the source code of parts of the ProzillaOS website. They
ProzillaOS uses the package manager [pnpm](https://pnpm.io/) to run scripts.
-### Shorthands
+### Global
| Script | Description |
| --- | --- |
@@ -74,24 +74,25 @@ ProzillaOS uses the package manager [pnpm](https://pnpm.io/) to run scripts.
### Internal package: `@prozilla-os/demo`
-| Script | Linked package script |
+| Script | Description |
| --- | --- |
-| pnpm run demo:start
| [`pnpm run start`](./packages/demo/README.md#scripts)
-| pnpm run demo:build
| [`pnpm run build`](./packages/demo/README.md#scripts)
-| pnpm run demo:preview
| [`pnpm run preview`](./packages/demo/README.md#scripts)
-| pnpm run demo:stage
| [`pnpm run stage`](./packages/demo/README.md#scripts)
-| pnpm run demo:deploy
| [`pnpm run deploy`](./packages/demo/README.md#scripts)
-| pnpm run demo:fetch
| [`pnpm run fetch`](./packages/demo/README.md#scripts)
+| pnpm run demo:start
| See [`pnpm run start`](./packages/demo/README.md#scripts)
+| pnpm run demo:build
| See [`pnpm run build`](./packages/demo/README.md#scripts)
+| pnpm run demo:preview
| See [`pnpm run preview`](./packages/demo/README.md#scripts)
+| pnpm run demo:stage
| See [`pnpm run stage`](./packages/demo/README.md#scripts)
+| pnpm run demo:deploy
| See [`pnpm run deploy`](./packages/demo/README.md#scripts)
+| pnpm run demo:fetch
| See [`pnpm run fetch`](./packages/demo/README.md#scripts)
### Internal package: `@prozilla-os/docs`
-| Script | Linked package script |
+| Script | Description |
| --- | --- |
-| pnpm run docs:start
| [`pnpm run start`](./packages/docs/README.md#scripts)
-| pnpm run docs:build
| [`pnpm run build`](./packages/docs/README.md#scripts)
-| pnpm run docs:preview
| [`pnpm run preview`](./packages/docs/README.md#scripts)
-| pnpm run docs:stage
| [`pnpm run stage`](./packages/docs/README.md#scripts)
-| pnpm run docs:generate
| [`pnpm run generate`](./packages/docs/README.md#scripts)
+| pnpm run docs:start
| See [`pnpm run start`](./packages/docs/README.md#scripts)
+| pnpm run docs:build
| See [`pnpm run build`](./packages/docs/README.md#scripts)
+| pnpm run docs:preview
| See [`pnpm run preview`](./packages/docs/README.md#scripts)
+| pnpm run docs:stage
| See [`pnpm run stage`](./packages/docs/README.md#scripts)
+| pnpm run docs:deploy
| Build and stage docs, then run `pnpm run publish`.
+| pnpm run docs:generate
| See [`pnpm run generate`](./packages/docs/README.md#scripts)
## Links