diff --git a/packages/astro/src/@types/astro.ts b/packages/astro/src/@types/astro.ts
index 8d735bf23..0721ba82c 100644
--- a/packages/astro/src/@types/astro.ts
+++ b/packages/astro/src/@types/astro.ts
@@ -424,15 +424,22 @@ export interface AstroUserConfig {
 	 * @name base
 	 * @type {string}
 	 * @description
-	 * The base path to deploy to. Astro will build your pages and assets using this path as the root. Currently, this has no effect during development.
+	 * The base path to deploy to. Astro will use this path as the root for your pages and assets both in development and in production build. 
 	 *
-	 * You can access this value in your app via `import.meta.env.BASE_URL`.
+	 * In the example below, `astro dev` will start your server at `/docs`.
 	 *
 	 * ```js
 	 * {
 	 *   base: '/docs'
 	 * }
 	 * ```
+	 * 
+	 * When using this option, all of your static asset imports and URLs should add the base as a prefix. You can access this value via `import.meta.env.BASE_URL`.
+	 * 
+	 * ```astro
+	 * <a href="/docs/about/">About</a>
+	 * <img src=`${import.meta.env.BASE_URL}/image.png`>
+	 * ```
 	 */
 	base?: string;