diff --git a/packages/astro/src/types/public/config.ts b/packages/astro/src/types/public/config.ts
index d39b2f3d69..9166ddcbe3 100644
--- a/packages/astro/src/types/public/config.ts
+++ b/packages/astro/src/types/public/config.ts
@@ -468,7 +468,7 @@ export interface AstroUserConfig {
 		 * @name security.checkOrigin
 		 * @kind h4
 		 * @type {boolean}
-		 * @default 'true'
+		 * @default `true`
 		 * @version 4.9.0
 		 * @description
 		 *
@@ -1418,13 +1418,16 @@ export interface AstroUserConfig {
 
 	/**
 	 * @docs
+	 * @kind heading
 	 * @name env
 	 * @type {object}
 	 * @default `{}`
 	 * @version 5.0.0
 	 * @description
 	 *
-	 * Holds `astro:env` options.
+	 * Configuration options for type-safe environment variables.
+	 *
+	 * See our guide for more information on [environment variables in Astro](/en/guides/environment-variables/).
 	 */
 	env?: {
 		/**