address review comments

CHANGELOG.md

@@ -12,18 +12,18 @@ Updated PECL release packages. Here is the list of updates:
   - Support for inserting into and modifying an encrypted column
   - Support for fetching from an encrypted column
 - Added support for PHP 7.2
-- Added support for MSODBC 17
-- Added support for Ubuntu 17 (requires MSODBC 17)
-- Added support for Debian 9 (requires MSODBC 17)
+- Added support for MS ODBC Driver 17
+- Added support for Ubuntu 17 (requires MS ODBC Driver 17)
+- Added support for Debian 9 (requires MS ODBC Driver 17)
 - Added support for SUSE 12
-- Added Driver option to set the ODBC driver, Added "Driver" option, valid values are ODBC Driver 17 for SQL Server,ODBC Driver 13 for SQL Server, and ODBC Driver 11 for SQL Server
+- Added Driver option to set the MS ODBC driver, Added "Driver" option, valid values are "ODBC Driver 17 for SQL Server", "ODBC Driver 13 for SQL Server", and "ODBC Driver 11 for SQL Server"
   - The default driver is ODBC Driver 17 for SQL Server
 
 ### Changed
 - Implementation of PDO::lastInsertId($name) to return the last inserted sequence number if the sequence name is supplied to the function ([lastInsertId](https://github.com/Microsoft/msphpsql/wiki/Features#lastinsertid))
 
 ### Fixed
-- Issue [#555](https://github.com/Microsoft/msphpsql/issues/555) - Hebrew strings truncation (requires MSODBC 17)
+- Issue [#555](https://github.com/Microsoft/msphpsql/issues/555) - Hebrew strings truncation (requires MS ODBC Driver 17)
 - Adjusted precisions for numeric/decimal inputs with Always Encrypted
 - Support for non-UTF8 locales in Linux and macOS
 - Fixed crash caused by executing an invalid query in a transaction (Issue [#434](https://github.com/Microsoft/msphpsql/issues/434))
@@ -34,23 +34,23 @@ Updated PECL release packages. Here is the list of updates:
 - BIGINT as an output param no longer results in value out of range exception when the returned value is larger than a maximum integer ([PR #567](https://github.com/Microsoft/msphpsql/pull/567))
 
 ### Removed
-- No longer support Ubuntu 15
+- Dropped support for Ubuntu 15
 - Supplying tablename into PDO::lastInsertId($name) no longer return the last inserted row ([lastInsertId](https://github.com/Microsoft/msphpsql/wiki/Features#lastinsertid))
 
 ### Limitations
-- Always Encrypted is not support in Linux and macOS
-- In Linux and macOS, setlocale() only takes effect if it is invoked before the first connection. The subsequent locale setting will not work
-- Always Encrypted functionalities are only supported using MSODBC 17
+- Always Encrypted is not supported in Linux and macOS
+- In Linux and macOS, setlocale() only takes effect if it is invoked before the first connection. Attempting to set the locale after connection will not work
+- Always Encrypted functionalities are only supported using MS ODBC Driver 17
 - [Always Encrypted limitations](https://github.com/Microsoft/msphpsql/wiki/Features#aelimitation)
 - When using sqlsrv_query with Always Encrypted feature, SQL type has to be specified for each input (see [here](https://github.com/Microsoft/msphpsql/wiki/Features#aebindparam))
 - No support for inout / output params when using sql_variant type
 
 ### Known Issues
-- Connection pooling on Linux doesn't work properly when using the MSODBC 17
+- Connection pooling on Linux doesn't work properly when using MS ODBC Driver 17
 - When pooling is enabled in Linux or macOS
   - unixODBC <= 2.3.4 (Linux and macOS) might not return proper diagnostics information, such as error messages, warnings and informative messages
   - due to this unixODBC bug, fetch large data (such as xml, binary) as streams as a workaround. See the examples [here](https://github.com/Microsoft/msphpsql/wiki/Connection-Pooling-on-Linux-and-Mac)
-- Connection with Connection Resiliency enabled so not resume properly with Connection Pooling (Issue [#678](https://github.com/Microsoft/msphpsql/issues/678))
+- Connection with Connection Resiliency enabled does not resume properly with Connection Pooling (Issue [#678](https://github.com/Microsoft/msphpsql/issues/678))
 - With ColumnEncryption enabled, calling stored procedure with XML parameter does not work (Issue [#674](https://github.com/Microsoft/msphpsql/issues/674))
 - Cannot connect with both Connection Resiliency enabled and ColumnEncryption enabled (Issue [#577](https://github.com/Microsoft/msphpsql/issues/577))
 - With ColumnEncryption enabled, retrieving a negative decimal value as output parameter causes truncation of the last digit (Issue [#705](https://github.com/Microsoft/msphpsql/issues/705))