From 2d96c76e37c91b4797152fb855403dc8d559c329 Mon Sep 17 00:00:00 2001
From: Chris Swithinbank <swithinbank@gmail.com>
Date: Sat, 7 May 2022 09:56:39 +0200
Subject: [PATCH] docs: Update server options configuration reference (#3295)

Based on https://github.com/withastro/docs/pull/422/

Co-Authored-By: Rafid Muhymin Wafi <63650415+RafidMuhymin@users.noreply.github.com>

Co-authored-by: Rafid Muhymin Wafi <63650415+RafidMuhymin@users.noreply.github.com>
---
 src/@types/astro.ts | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/src/@types/astro.ts b/src/@types/astro.ts
index 854ed875c60f..8a04f21e94cf 100644
--- a/src/@types/astro.ts
+++ b/src/@types/astro.ts
@@ -432,11 +432,11 @@ export interface AstroUserConfig {
 	 * @name Server Options
 	 * @description
 	 *
-	 * Customize the Astro dev server, used by both `astro dev` and `astro serve`.
+	 * Customize the Astro dev server, used by both `astro dev` and `astro preview`.
 	 *
 	 * ```js
 	 * {
-	 *   server: {port: 1234, host: true}
+	 *   server: { port: 1234, host: true}
 	 * }
 	 * ```
 	 *
@@ -445,7 +445,7 @@ export interface AstroUserConfig {
 	 * ```js
 	 * {
 	 *   // Example: Use the function syntax to customize based on command
-	 *   server: (command) => ({port: command === 'dev' ? 3000 : 4000})
+	 *   server: (command) => ({ port: command === 'dev' ? 3000 : 4000 })
 	 * }
 	 * ```
 	 */
@@ -457,10 +457,10 @@ export interface AstroUserConfig {
 	 * @default `false`
 	 * @version 0.24.0
 	 * @description
-	 * Set which network IP addresses the dev server should listen on (i.e. 	non-localhost IPs).
+	 * Set which network IP addresses the server should listen on (i.e. non-localhost IPs).
 	 * - `false` - do not expose on a network IP address
 	 * - `true` - listen on all addresses, including LAN and public addresses
-	 * - `[custom-address]` - expose on a network IP address at `[custom-address]`
+	 * - `[custom-address]` - expose on a network IP address at `[custom-address]` (ex: `192.168.0.1`)
 	 */
 
 	/**
@@ -469,9 +469,15 @@ export interface AstroUserConfig {
 	 * @type {number}
 	 * @default `3000`
 	 * @description
-	 * Set which port the dev server should listen on.
+	 * Set which port the server should listen on.
 	 *
 	 * If the given port is already in use, Astro will automatically try the next available port.
+	 *
+	 * ```js
+	 * {
+	 *   server: { port: 8080 }
+	 * }
+	 * ```
 	 */
 
 	server?: ServerConfig | ((options: { command: 'dev' | 'preview' }) => ServerConfig);