From ed6cb5b0122801dab10f5542d831b45354325ade Mon Sep 17 00:00:00 2001
From: Adam James <atj@pulsewidth.org.uk>
Date: Thu, 19 May 2022 10:56:31 +0100
Subject: [PATCH] Minor NAD integration improvements (#22804)

---
 source/_integrations/nad.markdown | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/source/_integrations/nad.markdown b/source/_integrations/nad.markdown
index 55b008b59a9..0873b8ecc48 100644
--- a/source/_integrations/nad.markdown
+++ b/source/_integrations/nad.markdown
@@ -13,12 +13,12 @@ ha_integration_type: integration
 
 The `nad` platform allows you to control a [NAD receiver](https://nadelectronics.com/) through RS232, TCP and Telnet from Home Assistant.
 
-Please note that the RS232 interface is only tested with the NAD T748v2, but is should work with more NAD receivers.
-The Telnet interface is only tested with the NAD T787.
+Please note that the RS232 interface is only tested with the NAD T748v2, but it should work with other NAD receivers.
+The Telnet interface has been tested with the NAD T787 and the NAD C658.
 
 ## Configuration
 
-To add an NAD receiver to your installation, add the following to your `configuration.yaml` file:
+To add a NAD receiver to your installation, add the following to your `configuration.yaml` file:
 
 ```yaml
 # Example configuration.yaml entry for RS232 configuration
@@ -27,6 +27,14 @@ media_player:
     serial_port: /dev/ttyUSB0
 ```
 
+```yaml
+# Example configuration.yaml entry for Telnet configuration
+media_player:
+  - platform: nad
+    type: Telnet
+    host: "IP_ADDRESS"
+```
+
 ```yaml
 # Example configuration.yaml entry for TCP configuration
 media_player:
@@ -71,7 +79,7 @@ max_volume:
   default: -20
   type: integer
 sources:
-  description: A list of mappings from source to source name. Valid sources are `1 to 10`. (for `RS232` and `Telnet` types)
+  description: A list of mappings from source to source name. Valid sources are `1 to 12`. (for `RS232` and `Telnet` types)
   required: false
   type: [list, string]
 volume_step:
@@ -81,7 +89,7 @@ volume_step:
   type: integer
 {% endconfiguration %}
 
-The min_volume and max_volume are there to protect you against misclicks on the slider so you will not blow up your speakers when you go from -92dB to +20dB. You can still force it to go higher or lower than the values set with the plus and minus buttons.
+The `min_volume` and `max_volume` options are there to protect you against misclicks on the slider so you will not blow up your speakers when you go from -92dB to +20dB. You can still force higher or lower volumes than the values set by using the plus and minus buttons.
 
 <div class='note warning'>
 
@@ -91,7 +99,7 @@ Be aware that the user might need to logout and logon again to activate these pe
 
 </div>
 
-A full configuration example could look like this:
+An example of a full configuration:
 
 ```yaml
 # Example configuration.yaml entry