chore: add autogenerated docs for serve command (#5402)

Author: khendrikse

CONTRIBUTING.md

@@ -131,6 +131,27 @@ output.
 DEBUG_TESTS=true npm exec vitest -- run tests/unit/tests/unit/lib/account.test.mjs -t 'test name'
 ```
 
+### Command docs
+
+
+If you're adding a new command, make sure to also add docs for it by creating a new `[commandname].md` file to the `docs` folder and adding the following information:
+
+```md
+---
+title: Netlify CLI [command name] command
+description: A description.
+---
+
+# `command name`
+
+<!-- AUTO-GENERATED-CONTENT:START (GENERATE_COMMANDS_DOCS) -->
+
+<!-- AUTO-GENERATED-CONTENT:END -->
+
+```
+
+Then autogenerate the docs by running `npm run docs`.
+
 ### Lint docs per Netlify style guide
 
 1. [Install vale](https://docs.errata.ai/vale/install)

docs/commands/serve.md

@@ -0,0 +1,39 @@
+---
+title: Netlify CLI serve command
+description: (Beta) Build the site for production and serve locally. This does not watch the code for changes, so if you need to rebuild your site then you must exit and run `serve` again.
+---
+
+# `serve`
+
+<!-- AUTO-GENERATED-CONTENT:START (GENERATE_COMMANDS_DOCS) -->
+(Beta) Build the site for production and serve locally. This does not watch the code for changes, so if you need to rebuild your site then you must exit and run `serve` again.
+
+**Usage**
+
+```bash
+netlify serve
+```
+
+**Flags**
+
+- `context` (*string*) - Specify a deploy context or branch for environment variables (contexts: "production", "deploy-preview", "branch-deploy", "dev")
+- `country` (*string*) - Two-letter country code (https://ntl.fyi/country-codes) to use as mock geolocation (enables --geo=mock automatically)
+- `dir` (*string*) - dir with static files
+- `functions` (*string*) - specify a functions folder to serve
+- `functions-port` (*string*) - port of functions server
+- `geo` (*cache | mock | update*) - force geolocation data to be updated, use cached data from the last 24h if found, or use a mock location
+- `offline` (*boolean*) - disables any features that require network access
+- `debug` (*boolean*) - Print debugging information
+- `http-proxy` (*string*) - Proxy server address to route requests through.
+- `http-proxy-certificate-filename` (*string*) - Certificate file to use when connecting using a proxy server
+- `port` (*string*) - port of netlify dev
+
+**Examples**
+
+```bash
+netlify serve
+BROWSER=none netlify serve # disable browser auto opening
+```
+
+
+<!-- AUTO-GENERATED-CONTENT:END -->

src/commands/serve/index.mjs

@@ -0,0 +1 @@
+export { createServeCommand } from './serve.mjs'