diff --git a/versions/3.0.4.md b/versions/3.0.4.md
index f91190b457..7eda3ef459 100644
--- a/versions/3.0.4.md
+++ b/versions/3.0.4.md
@@ -445,7 +445,7 @@ The following shows how variables can be used for a server configuration:
"variables": {
"username": {
"default": "demo",
- "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
+ "description": "A user-specific subdomain. Use `demo` for a free sandbox environment."
},
"port": {
"enum": ["8443", "443"],
@@ -468,7 +468,7 @@ servers:
username:
# note! no enum here means it is an open value
default: demo
- description: this value is assigned by the service provider, in this example `gigantic-server.com`
+ description: A user-specific subdomain. Use `demo` for a free sandbox environment.
port:
enum:
- '8443'
@@ -488,7 +488,7 @@ An object representing a Server Variable for server URL template substitution.
| Field Name | Type | Description |
| ---- | :----: | ---- |
| enum | [`string`] | An enumeration of string values to be used if the substitution options are from a limited set. The array SHOULD NOT be empty. |
-| default | `string` | **REQUIRED**. The default value to use for substitution, which SHALL be sent if an alternate value is _not_ supplied. Note this behavior is different than the [Schema Object's](#schema-object) treatment of default values, because in those cases parameter values are optional. If the [`enum`](#server-variable-enum) is defined, the value SHOULD exist in the enum's values. |
+| default | `string` | **REQUIRED**. The default value to use for substitution, which SHALL be sent if an alternate value is _not_ supplied. If the [`enum`](#server-variable-enum) is defined, the value SHOULD exist in the enum's values. Note that this behavior is different from the [Schema Object](#schema-object)'s `default` keyword, which documents the receiver's behavior rather than inserting the value into the data. |
| description | `string` | An optional description for the server variable. [CommonMark syntax](https://spec.commonmark.org/) MAY be used for rich text representation. |
This object MAY be extended with [Specification Extensions](#specification-extensions).