diff --git a/crates/extension/src/types/context_server.rs b/crates/extension/src/types/context_server.rs
index e0bac5b0d9..2e3d20b047 100644
--- a/crates/extension/src/types/context_server.rs
+++ b/crates/extension/src/types/context_server.rs
@@ -1,10 +1,10 @@
-/// Configuration for a context server.
+/// Configuration for context server setup and installation.
 #[derive(Debug, Clone)]
 pub struct ContextServerConfiguration {
-    /// Installation instructions for the user.
+    /// Installation instructions in Markdown format.
     pub installation_instructions: String,
-    /// Default settings for the context server.
-    pub default_settings: String,
-    /// JSON schema describing server settings.
+    /// JSON schema for settings validation.
     pub settings_schema: serde_json::Value,
+    /// Default settings template.
+    pub default_settings: String,
 }
diff --git a/crates/extension_api/wit/since_v0.5.0/context-server.wit b/crates/extension_api/wit/since_v0.5.0/context-server.wit
index 89dc99c85b..7234e0e6d0 100644
--- a/crates/extension_api/wit/since_v0.5.0/context-server.wit
+++ b/crates/extension_api/wit/since_v0.5.0/context-server.wit
@@ -1,11 +1,11 @@
 interface context-server {
-    ///
+    /// Configuration for context server setup and installation.
     record context-server-configuration {
-        ///
+        /// Installation instructions in Markdown format.
         installation-instructions: string,
-        ///
+        /// JSON schema for settings validation.
         settings-schema: string,
-        ///
+        /// Default settings template.
         default-settings: string,
     }
 }