address feedback; fix typo in release notes

Author: aimeeu

content/nomad/v1.11.x/content/docs/deploy/clusters/connect-nodes.mdx

@@ -220,43 +220,37 @@ options.
 
 ## Use client node introduction tokens
 
-You may restrict which clients join your cluster with a client
-introduction token. The client node introduction feature is like multi-factor
-authentication for your Nomad clusters. It does not replace mTLS but adds an
-additional layer of security to prevent an unauthorized or misconfigured client
-from joining a Nomad cluster. Although you do not need to configure mTLS to use
-client node introduction tokens, we do recommend securing your cluster with mTLS.
-
-Each security layer answers a distinct question:
-
-- mTLS: Does the client have valid certificates for the cluster?
-- Client introduction token: Does the client have a valid token to join the
-cluster?
+Use client introduction tokens to restrict which clients join your cluster. The
+client node introduction feature is like multi-factor authentication for your
+Nomad clusters. **It does not replace mTLS**, but instead adds an additional
+layer of security that prevents an unauthorized or misconfigured client from
+joining a Nomad cluster.
 
 When you generate a client introduction token, you may specify the following
-optional parameters:
+optional parameters to further secure cluster access:
 
 - Node pool: The node pool that clients with this token may join. This
   token is not valid with any other node pool.
 - Node name: The token is scoped to the node with this name. No other node may
   use this token to join the cluster.
 - TTL: Token expiration. The token is not valid after expiration.
 
+### Create a client introduction token
 
 Follow these steps to use client node introduction tokens:
 
 1. [Create an ACL node policy](#create-an-acl-policy).   
 1. [Create an ACL role from the policy](#create-an-acl-role).
 1. [Generate a client introduction token](#generate-a-client-introduction-token).
-1. [Configure the Nomad agent to use client introduction](#configure-the-nomad-agent).
-1. [Start the Nomad agent](#start-the-nomad-agent).
+1. [Update your Nomad server configuration to use client introduction](#update-your-nomad-server-configuration).
+1. [Start the Nomad server](#start-the-nomad-server).
 1. [Monitor client join failures](#monitor-client-join-failures).
 
 ### Prerequisites
 
-- You have [bootstrapped the ACL system](/nomad/docs/secure/acl/bootstrap).
-- You have a management token.
-- You have configured the CLI to use the management token.
+You bootstrapped the ACL system and configured the CLI to use your management
+token. Refer to the [Bootstrap the ACL system
+guide](/nomad/docs/secure/acl/bootstrap) for instructions.
 
 ### Create an ACL policy
 
@@ -315,12 +309,11 @@ The `intro-token.jwt` file contains the JWT.
  "eyJhbGciOiJSUzI1NiIsImtpZCI6IjljZDgy..."
 ```
 
-### Configure the Nomad agent
+### Update your Nomad server configuration
 
-Configure the Nomad agent's `server.client_introduction` block. This example
-sets the `enforcement` parameter to `strict`, which means the agent rejects any
-client without a valid token. Refer to the [`server.client_introduction`
-block
+Configure your Nomad server's `server.client_introduction` block. This example
+sets strict enforcement, which means the server rejects any client without a
+valid token. Refer to the [`server.client_introduction` block
 documentation](/nomad/docs/configuration/server#client_introduction-parameters)
 for additional enforcement options.
 
@@ -336,8 +329,8 @@ server {
   bootstrap_expect = 1
   client_introduction {
     enforcement          = "strict" # Default = "warn"
-    default_identity_ttl = "15m"     # Default = "5m"
-    max_identity_ttl     = "60m"    # Default = "30m"
+    default_identity_ttl = "5m"     # Default = "5m"
+    max_identity_ttl     = "30m"    # Default = "30m"
   }
 }
 tls {
@@ -351,12 +344,12 @@ tls {
 
 </CodeBlockConfig>
 
-There is no additional client configuration.
+No additional configuration is required on the client node.
 
-### Start the Nomad agent
+### Start the Nomad server
 
 You have the following options for passing the client introduction token to the
-Nomad agent:
+Nomad server:
 
 - Set the token as the value of a `NOMAD_CLIENT_INTRO_TOKEN` environment
   variable.
@@ -366,7 +359,7 @@ Nomad agent:
 - Place the `intro_token.jwt` file in the client's state directory, which is by
   default [the `<data_dir>/client_state_dir>` directory](/nomad/docs/configuration/client#state_dir).
 
-This example starts the agent with the client introduction token passed in the
+This example starts the server with the client introduction token passed in the
 `-client-intro-token` parameter.
 
 ```shell-session
@@ -378,7 +371,7 @@ nomad agent -config /etc/nomad.d/nomad.hcl \
 
 You have the following options to determine when client registration fails:
 
-- Check the agent logs for `[ERROR] nomad.client: node registration without
+- Check the server logs for `[ERROR] nomad.client: node registration without
   introduction token` messages.
 - Monitor the [`nomad.client.introduction.enforcement`
   counter](/nomad/docs/monitor#client-introduction), which increments when a

content/nomad/v1.11.x/content/docs/release-notes/nomad/v1-11-x.mdx

@@ -13,7 +13,7 @@ We are pleased to announce the following Nomad updates.
 
 ### Client node introduction and identity
 
-Nomad's client node identity feature uniquely identities each Nomad client node
+Nomad's client node identity feature uniquely identifies each Nomad client node
 and provides an authentication mechanism for nodes to make RPC calls to the
 Nomad servers. 
 
@@ -35,7 +35,7 @@ Using a client introduction token gives you additional control over misconfigure
 - [Client node identity concepts](/nomad/docs/architecture/cluster/node-identity)
 - [Client identity node pool TTL configuration
   option](/nomad/docs/other-specifications/node-pool#node_identity_ttl)
-- [Use client node introduction tokens to connect clients to your Nomad agent](/nomad/docs/deploy/clusters/connect-nodes#use-client-node-introduction-tokens)
+- [Use client node introduction tokens to connect clients to your Nomad server](/nomad/docs/deploy/clusters/connect-nodes#use-client-node-introduction-tokens)
 - [Client introduction server configuration options](/nomad/docs/configuration/server#client_introduction-parameters)
 - [Client introduction monitoring detail](/nomad/docs/monitor#client-introduction)
 - [Client introduction agent CLI token flag](/nomad/commands/agent#client-intro-token)