diff --git a/packages/core/http/core-http-server-internal/src/http_config.ts b/packages/core/http/core-http-server-internal/src/http_config.ts
index 201770eba269..eba98e725e80 100644
--- a/packages/core/http/core-http-server-internal/src/http_config.ts
+++ b/packages/core/http/core-http-server-internal/src/http_config.ts
@@ -178,9 +178,10 @@ const configSchema = schema.object(
 
     versioned: schema.object({
       /**
-       * Which handler resolution algo to use: "newest" or "oldest".
+       * Which handler resolution algo to use for public routes: "newest" or "oldest".
        *
-       * @note in development we have an additional option "none" which is also the default.
+       * @note Internal routes always require a version to be specified.
+       * @note in development we have an additional option "none" which is also the default in dev.
        *       This prevents any fallbacks and requires that a version specified.
        *       Useful for ensuring that a given client always specifies a version.
        */