Clean up docs page (#13854)

Author: raymondjacobson

docs/.vscode/settings.json

@@ -1,9 +1,5 @@
 {
   "editor.rulers": [100],
-  "workbench.colorCustomizations": {
-    "titleBar.activeBackground": "#7E1BCC",
-    "titleBar.activeForeground": "#FFF"
-  },
   "prettier.proseWrap": "always",
   "[mdx]": {
     "editor.formatOnSave": true,

docs/README.md

@@ -1,61 +1,51 @@
 # docs.audius.co
 
-## Dependencies
+Audius Developer Docs built with [Vocs](https://vocs.dev).
 
-Install dependencies:
+## Setup
 
 ```sh
 npm install
 ```
 
----
-
-## Development Server
-
-To run the docs locally:
+## Development
 
 ```sh
 npm run dev
 ```
 
-To develop on Cloudflare pages and test the whole stack:
+Runs the Vocs dev server. For Cloudflare Pages testing:
 
 ```sh
 npm run pages:dev
 ```
 
----
-
-## Updating the API Spec
-
-The API reference uses Stoplight Elements and loads the OpenAPI spec from `/openapi.yaml`. To sync the latest spec from the live API:
+## Build & Preview
 
 ```sh
-npm run sync:api-spec
+npm run build
+npm run preview
 ```
 
-This script:
-
-- Downloads `https://api.audius.co/v1/swagger.yaml`
-- Rewrites any legacy `discoveryprovider.audius.co` hosts to `api.audius.co`
-- Saves the patched spec to `docs/public/openapi.yaml`
-- Deduplicates server entries
+`preview` serves the production build locally.
 
----
+## Deploy
 
-## Build
+From the `main` branch:
 
 ```sh
-npm run build
+npm run pages:deploy
 ```
 
----
+Builds and deploys to Cloudflare Pages. Requires `wrangler login` if not authenticated.
 
-## Publish
+## API Spec
 
-To deploy to docs.audius.co, run from the `main` branch:
+The API reference loads the OpenAPI spec from `/openapi.yaml`. To sync from the live API:
 
 ```sh
-npm run build
-npm run pages:deploy
+npm run sync:api-spec
 ```
+
+Downloads `https://api.audius.co/v1/swagger.yaml`, patches hosts to `api.audius.co`, deduplicates
+servers, and saves to `docs/public/openapi.yaml`.