fixup: apply PR suggestions

website/content/commands/acl/token/create.mdx

@@ -76,6 +76,8 @@ Usage: `consul acl token create [options] [args]`
 
 ## Examples
 
+The following examples describe the creation of ACL tokens for common scenarios.
+
 ### Create a token with policy by name
 
 ```shell-session
@@ -91,10 +93,11 @@ Policies:
 
 ### Create a token for a service
 
-This creates a token with the privileges necessary to register the service `my-api`.
+The following example creates a token with the privileges necessary
-If `my-api` is in the service mesh, this token also has the privileges necessary
+for registering a service named `my-api`.
-to register its associated sidecar proxy and should be passed to the proxy when
+If `my-api` is in the service mesh, the token also has the privileges necessary
-launched with [`consul connect envoy`](/consul/commands/connect/envoy).
+to register its associated sidecar proxy and must be provided to the proxy when
+launched with [`consul connect envoy`](/consul/commands/connect/envoy#sidecar-proxy-with-acls-enabled).
 
 ```shell-session
 $ consul acl token create -description 'my-api token' -service-identity 'my-api'
@@ -107,7 +110,7 @@ Service Identities:
    my-api (Datacenters: all)
 ```
 
-### Create a short-lived, highly privileged token
+### Create a short-lived and highly privileged token
 
 ```shell-session
 $ consul acl token create -description "Temp Super User" -policy-name global-management -expires-ttl '15m'

website/content/commands/connect/envoy.mdx

@@ -219,7 +219,7 @@ service {
 }
 ```
 
-### Basic Sidecar Proxy
+### Basic sidecar proxy
 
 The sidecar Envoy process can be started with.
 
@@ -231,23 +231,28 @@ This example assumes that the correct [environment variables](#api-options) are
 used to set the local agent connection information and ACL token, or that the
 agent is using all-default configuration.
 
-### Sidecar Proxy with ACLs Enabled
+### Sidecar proxy with ACLs enabled
 
 In secure deployments, Consul's ACL system is enabled with a default `deny` policy.
-Nothing can access Consul API resources unless it presents a Consul ACL token with the
+To access Consul API resources, an API request must present a Consul ACL token
-necessary privileges. A sidecar proxy must have a Consul ACL token to act as itself and
+with the necessary privileges. A sidecar proxy must be provided with an ACL token
-the service it fronts, and to access all that service's potential upstreams.
+with privileges to register itself and the service it fronts,
-The best way to generate such a token is to
+and to access all potential upstreams of that service.
-[use a service identity](/consul/commands/acl/token/create#create-a-token-for-a-service).
+We recommend [using a service identity](/consul/commands/acl/token/create#create-a-token-for-a-service)
-
+to directly create a token with the privileges necessary for a service and its sidecar proxy,
-Then, provide that token when launching the Envoy sidecar proxy instance with
+rather than creating a unique ACL policy for every service.
-the `consul connect envoy` command through either:
+
-- Environment variables
+After creating a token using a service identity, provide the token when
-  [`CONSUL_HTTP_TOKEN`](/consul/commands#consul_http_token) or
+launching the Envoy sidecar proxy instance with the `consul connect envoy` command.
-  [`CONSUL_HTTP_TOKEN_FILE`](/consul/commands#consul_http_token_file)
+You can provide the token through an environment variable or CLI flag.
-- CLI flags
+
-  [`-token`](/consul/commands/connect/envoy#token) or
+Environment variables:
-  [`-token-file`](/consul/commands/connect/envoy#token-file)
+- [`CONSUL_HTTP_TOKEN`](/consul/commands#consul_http_token) or
+- [`CONSUL_HTTP_TOKEN_FILE`](/consul/commands#consul_http_token_file)
+
+CLI flags:
+- [`-token`](/consul/commands/connect/envoy#token) or
+- [`-token-file`](/consul/commands/connect/envoy#token-file)
 
 ```shell-session
 $ export CONSUL_HTTP_TOKEN="<secret-id-of-token-with-service-identity-for-web>"