diff --git a/website/content/docs/agent/config/config-files.mdx b/website/content/docs/agent/config/config-files.mdx
index 593ab5237c..be94d0bf53 100644
--- a/website/content/docs/agent/config/config-files.mdx
+++ b/website/content/docs/agent/config/config-files.mdx
@@ -1346,9 +1346,9 @@ Valid time units are 'ns', 'us' (or 'µs'), 'ms', 's', 'm', 'h'."
- `prefer_namespace` ((#dns_prefer_namespace)) **Deprecated in Consul 1.11.
Use the [canonical DNS format for enterprise service lookups](/docs/discovery/dns#service-lookups-for-consul-enterprise) instead.** -
- When set to true, in a DNS query for a service, a single label between the domain
+ When set to `true`, in a DNS query for a service, a single label between the domain
and the `service` label is treated as a namespace name instead of a datacenter.
- When set to false, the default, the behavior is the same as non-Enterprise
+ When set to `false`, the default, the behavior is the same as non-Enterprise
versions and treats the single label as the datacenter.
- `domain` Equivalent to the [`-domain` command-line flag](/docs/agent/config/cli-flags#_domain).
diff --git a/website/content/docs/discovery/dns.mdx b/website/content/docs/discovery/dns.mdx
index 51c0e97bef..29f3e9645b 100644
--- a/website/content/docs/discovery/dns.mdx
+++ b/website/content/docs/discovery/dns.mdx
@@ -186,13 +186,13 @@ foobar.node.dc1.consul. 0 IN A 10.1.10.12
Valid formats for RFC 2782 SRV lookups depend on
whether you want to filter results based on a service tag:
-- No filtering on service tag
+- No filtering on service tag:
```text
_._tcp[.service][.].
```
-- Filtering on service tag specified in the RFC 2782 protocol field
+- Filtering on service tag specified in the RFC 2782 protocol field:
```text
_._[.service][.].
@@ -367,8 +367,7 @@ refer to [service virtual IP lookups for Consul Enterprise](#service-virtual-ip-
#### Canonical format
Use the following query format to specify namespace, partition, and/or datacenter
-for all service lookup types except `.query`,
-including `.service`, `.connect`, `.virtual`, and `.ingress`.
+for `.service`, `.connect`, `.virtual`, and `.ingress` service lookup types.
All three fields (`namespace`, `partition`, `datacenter`) are optional.
```text
[.].service[..ns][..ap][..dc]
@@ -377,18 +376,19 @@ All three fields (`namespace`, `partition`, `datacenter`) are optional.
#### Alternative formats for specifying namespace
Though the [canonical format](#canonical-format) is recommended for readability,
-the following query formats may be used to specify namespace-only:
+you can use the following query formats specify namespace but not partition:
-- Specify namespace and datacenter pair
+- Specify both namespace and datacenter:
```text
[.].service...
```
- **Deprecated in Consul 1.11:**
- Specify namespace-only if DNS queries are addressed to a Consul agent with
+ Specify namespace without a datacenter,
+ which requires that DNS queries are addressed to a Consul agent with
[`dns_config.prefer_namespace`](/docs/agent/config/config-files#dns_prefer_namespace)
- set to true
+ set to `true`:
```text
[.].service..