Update READMEs for monorepo layout

Author: ChrisLovering

README.md

@@ -1,10 +1,28 @@
 # 👷 Workers
 Cloudflare Workers in use at Python Discord.
 
-READMEs in respective directories have instructions on deployment and usage.
-
 All workers are licensed under MIT.
 
+## Structure
+
+This is a monorepo managed with npm workspaces. Each worker lives in its own subdirectory with its own `wrangler.toml`. Dependencies are installed from the root.
+
+To deploy a specific worker:
+
+```
+npm run deploy:<worker>
+```
+
+## Workers
+
+| Directory | Description |
+| --- | --- |
+| [error-pages](error-pages/) | Serves HTML error pages from KV |
+| [report-uri](report-uri/) | Proxies CSP report URI requests |
+| [serve-robots](serve-robots/) | Serves `robots.txt` files from KV |
+| [short-urls](short-urls/) | Short URL redirects on pydis.com |
+| [url-unfurler](url-unfurler/) | Follows redirect chains to their destination |
+
 ## Deployment
 
-All workers are linted on Pull Requests and deployed to Cloudflare automatically upon merge.
+Workers are linted on pull requests and deployed to Cloudflare automatically on merge.

error-pages/README.md

@@ -4,11 +4,13 @@ This worker serves HTML error pages from Cloudflare KV based on the request path
 
 ## Deployment
 
-Install local dependencies with `npm install`.
+From the repo root, run `npm install` to install dependencies.
 
-Login to wrangler with `npx wrangler login`.
+Login with `npx wrangler login`, then deploy with:
 
-After you've authorised, you can make modifications to the worker and run `npm run deploy` to deploy.
+```
+npm run deploy -w error-pages
+```
 
 ## Usage
 

report-uri/README.md

@@ -4,11 +4,13 @@ This worker proxies CSP and other report URI requests over Cloudflare Workers to
 
 ## Deployment
 
-Install local dependencies with `npm install`.
+From the repo root, run `npm install` to install dependencies.
 
-Login to wrangler with `npx wrangler login`.
+Login with `npx wrangler login`, then deploy with:
 
-After you've authorised, you can make modifications to the worker and run `npm run deploy` to deploy.
+```
+npm run deploy -w report-uri
+```
 
 ## Usage
 

serve-robots/README.md

@@ -4,11 +4,13 @@ This worker servers `robots.txt` files at any domain proxied through Cloudflare
 
 ## Deployment
 
-Install local dependencies with `npm install`.
+From the repo root, run `npm install` to install dependencies.
 
-Login to wrangler with `npx wrangler login`.
+Login with `npx wrangler login`, then deploy with:
 
-After you've authorised, you can make modifications to the worker and run `npm run deploy` to deploy.
+```
+npm run deploy -w serve-robots
+```
 
 ## Usage
 

short-urls/README.md

@@ -4,13 +4,15 @@ This worker handles short URls redirection on pydis.com (for example, https://py
 
 URLs are stored in Workers KV and can be added in the Cloudflare Dashboard or through the Wrangler CLI.
 
-## Publishing
+## Deployment
 
-You need to install `wrangler` with `npm install -g @cloudflare/wrangler`.
+From the repo root, run `npm install` to install dependencies.
 
-Once you've installed this run `wrangler login`.
+Login with `npx wrangler login`, then deploy with:
 
-After you've authorised, you can make modifications to the worker and run `wrangler publish` to push them to the edge.
+```
+npm run deploy -w short-urls
+```
 
 ### Environment Variables
 

url-unfurler/README.md

@@ -6,11 +6,13 @@ This can be useful for finding out what's behind a shortened link, or any other
 
 ## Deployment
 
-Install dependencies with `npm install`.
+From the repo root, run `npm install` to install dependencies.
 
-Once you've installed this run `npx wrangler login`.
+Login with `npx wrangler login`, then deploy with:
 
-After you've authorised, you can make modifications to the worker and run `npm run deploy` to push them to the edge.
+```
+npm run deploy -w url-unfurler
+```
 
 ### Environment Variables