Address review comments

Author: ajlam

articles/mysql/concepts-connectivity-architecture.md

@@ -70,7 +70,10 @@ Azure Database for MySQL supports an additional connection policy, **redirection
 
 This feature is supported in Azure Database for MySQL servers with engine versions 5.6, 5.7, and 8.0.
 
-Preview support for redirection is available in the [PHP mysqlnd_azure](https://github.com/microsoft/mysqlnd_azure) extension, developed by Microsoft, and is available on [PECL](https://pecl.php.net/package/mysqlnd_azure). See the [configuring redirection](./howto-redirection.md) article for more information on how to use redirection in your applications.
+Support for redirection is available in the PHP [mysqlnd_azure](https://github.com/microsoft/mysqlnd_azure) extension, developed by Microsoft, and is available on [PECL](https://pecl.php.net/package/mysqlnd_azure). See the [configuring redirection](./howto-redirection.md) article for more information on how to use redirection in your applications.
+
+> [!IMPORTANT]
+> Support for redirection in the PHP [mysqlnd_azure](https://github.com/microsoft/mysqlnd_azure) extension is currently in preview.
 
 ## Next steps
 

articles/mysql/howto-redirection.md

@@ -13,7 +13,7 @@ ms.date: 03/16/2020
 This topic explains how to connect an application your Azure Database for MySQL server with redirection mode. Redirection aims to reduce network latency between client applications and MySQL servers by allowing applications to connect directly to backend server nodes.
 
 > [!IMPORTANT]
-> Support for redirection in the PHP [mysqlnd_azure](https://github.com/microsoft/mysqlnd_azure) is currently in preview.
+> Support for redirection in the PHP [mysqlnd_azure](https://github.com/microsoft/mysqlnd_azure) extension is currently in preview.
 
 ## Before you begin
 Sign in to the [Azure portal](https://portal.azure.com). Create an Azure Database for MySQL server with engine version 5.6, 5.7, or 8.0. For details, refer to [How to create Azure Database for MySQL server from Portal](quickstart-create-mysql-server-database-using-azure-portal.md) or [How to create Azure Database for MySQL server using CLI](quickstart-create-mysql-server-database-using-azure-cli.md).
@@ -24,15 +24,16 @@ Redirection is currently only supported when SSL is enabled. For details on how
 
 It is highly recommended to use PECL to install and configure the [mysqlnd_azure](https://pecl.php.net/package/mysqlnd_azure) extension. 
 
-Redirection logic/behavior beginning version 1.10 was updated and it is recommended to use 1.10+. 
-
 ### Redirection logic
 
-The redirection behavior is determined by the value of `mysqlnd_azure.enableRedirect`. The table below outlines the behavior of redirection based on the value of this parameter.
+>[!IMPORTANT]
+> Redirection logic/behavior beginning version 1.1.0 was updated and **it is recommended to use 1.1.0+**.
 
+The redirection behavior is determined by the value of `mysqlnd_azure.enableRedirect`. The table below outlines the behavior of redirection based on the value of this parameter beginning in **version 1.1.0+**.
 
+If you are using an older version of the mysqlnd_azure extension (version 1.0.0-1.0.3), the redirection behavior is determined by the value of `mysqlnd_azure.enabled`. The valid values are `off` (acts similarly as the behavior outlined in the table below) and `on` (acts like `preferred` in the table below).  
 
-|**`mysqlnd_azure.enableRedirect` value**| **Behavior**|
+|**mysqlnd_azure.enableRedirect value**| **Behavior**|
 |----------------------------------------|-------------|
 |`off` or `0`|Redirection will not be used. |
 |`on` or `1`|- If SSL is not enabled on the Azure Database for MySQL server, no connection will be made. The following error will be returned: *"mysqlnd_azure.enableRedirect is on, but SSL option is not set in connection string. Redirection is only possible with SSL."*<br>- If SSL is enabled on the MySQL server, but redirection is not supported on the server, the first connection is aborted and the following error is returned: *"Connection aborted because redirection is not enabled on the MySQL server or the network package doesn't meet redirection protocol."*<br>- If the MySQL server supports redirection, but the redirected connection failed for any reason, also abort the first proxy connection. Return the error of the redirected connection.|
@@ -48,7 +49,7 @@ The subsequent sections of the document will outline how to install the `mysqlnd
 - php-mysql
 - Azure Database for MySQL server with SSL enabled
 
-1. Install [mysqlnd_azure](https://github.com/microsoft/mysqlnd_azure) with [PECL](https://pecl.php.net/package/mysqlnd_azure). 
+1. Install [mysqlnd_azure](https://github.com/microsoft/mysqlnd_azure) with [PECL](https://pecl.php.net/package/mysqlnd_azure). It is recommended to use version 1.1.0+.
 
     ```bash
     sudo pecl install mysqlnd_azure
@@ -92,14 +93,14 @@ The subsequent sections of the document will outline how to install the `mysqlnd
     php -i | findstr "Thread"
     ```
 
-2. Download the corresponding x64 or x86 version of the [mysqlnd_azure](https://github.com/microsoft/mysqlnd_azure) DLL from [PECL](https://pecl.php.net/package/mysqlnd_azure) that matches your version of PHP. It is recommended to use version 1.10+.
+2. Download the corresponding x64 or x86 version of the [mysqlnd_azure](https://github.com/microsoft/mysqlnd_azure) DLL from [PECL](https://pecl.php.net/package/mysqlnd_azure) that matches your version of PHP. It is recommended to use version 1.1.0+.
 
 3. Extract the zip file and find the DLL named `php_mysqlnd_azure.dll`.
 
 4. Locate the extension directory (`extension_dir`) by running the below command:
 
     ```cmd
-    php -i | find "extension_dir"s
+    php -i | find "extension_dir"
     ```
 
 5. Copy the `php_mysqlnd_azure.dll` file into the directory returned in step 4. 
@@ -133,19 +134,21 @@ $host = '<yourservername>.mysql.database.azure.com';
 $username = '<yourusername>@<yourservername>';
 $password = '<yourpassword>';
 $db_name = 'testdb';
-  echo "mysqlnd_azure.enabled: ", ini_get("mysqlnd_azure.enabled") == true?"On":"Off", "\n";
+
+  echo "mysqlnd_azure.enableRedirect: ", ini_get("mysqlnd_azure.enableRedirect"), "\n";
   $db = mysqli_init();
-  $link = mysqli_real_connect ($db, $host, $username, $password, $db_name, 3306, NULL, MYSQLI_CLIENT_SSL);
+  //The connection must be configured with SSL for redirection test
+  $link = mysqli_real_connect ($db, 'your-hostname-with-redirection-enabled', 'user@host', 'password', "db", 3306, NULL, MYSQLI_CLIENT_SSL);
   if (!$link) {
      die ('Connect error (' . mysqli_connect_errno() . '): ' . mysqli_connect_error() . "\n");
   }
   else {
     echo $db->host_info, "\n"; //if redirection succeeds, the host_info will differ from the hostname you used used to connect
     $res = $db->query('SHOW TABLES;'); //test query with the connection
     print_r ($res);
-$db->close();
+    $db->close();
   }
- ?>
+?>
  ```
 
 ## Next steps