Update documentation.

Fix spelling errors; reword sections that didn't contain original content.

Author: bgrainger

docs/content/api/mysql-command.md

@@ -1,5 +1,5 @@
 ---
-lastmod: 2016-10-16
+lastmod: 2017-11-06
 date: 2016-10-16
 menu:
   main:
@@ -11,10 +11,10 @@ weight: 20
 MySqlCommand
 ==============
 
-MySqlCommand implements the [ADO.NET DbCommand class](https://docs.microsoft.com/en-us/dotnet/core/api/system.data.common.dbcommand),
+`MySqlCommand` implements the [ADO.NET DbCommand class](https://docs.microsoft.com/en-us/dotnet/core/api/system.data.common.dbcommand);
 please refer to its documentation.
 
-Additionally, MySqlCommand provides the following public properties and methods that may be used:
+Additionally, `MySqlCommand` provides the following public properties and methods that may be used:
 
 ### Constructors
 `public MySqlCommand()`
@@ -41,5 +41,6 @@ constructor accepting command SQL, connection object, and transaction object
 ### Additional Properties
 `public long LastInsertedId`
 
-Holds the value of the LastInsertedId after an SQL command inserting a row has been executed
+Holds the first automatically-generated ID for a value inserted in an `AUTO_INCREMENT` column in the last statement.
+See [`LAST_INSERT_ID()`](https://dev.mysql.com/doc/refman/8.0/en/information-functions.html#function_last-insert-id) for more information.
 ***

docs/content/api/mysql-connection.md

@@ -1,5 +1,5 @@
 ---
-lastmod: 2016-10-16
+lastmod: 2017-11-06
 date: 2016-10-16
 menu:
   main:
@@ -11,7 +11,7 @@ weight: 10
 MySqlConnection
 =================
 
-MySqlConnection implements the [ADO.NET DbConnection class](https://docs.microsoft.com/en-us/dotnet/core/api/system.data.common.dbconnection),
+MySqlConnection implements the [ADO.NET DbConnection class](https://docs.microsoft.com/en-us/dotnet/core/api/system.data.common.dbconnection);
 please refer to its documentation.
 
 Additionally, MySqlConnection provides the following public properties and methods that may be used:

docs/content/api/mysql-data-reader.md

@@ -1,5 +1,5 @@
 ---
-lastmod: 2016-10-16
+lastmod: 2017-11-06
 date: 2016-10-16
 menu:
   main:
@@ -11,7 +11,7 @@ weight: 30
 MySqlDataReader
 =================
 
-MySqlDataReader implements the [ADO.NET DbDataReader class](https://docs.microsoft.com/en-us/dotnet/core/api/system.data.common.dbdatareader),
+MySqlDataReader implements the [ADO.NET DbDataReader class](https://docs.microsoft.com/en-us/dotnet/core/api/system.data.common.dbdatareader);
 please refer to its documentation.
 
 Additionally, MySqlDataReader provides the following public properties and methods that may be used:
@@ -26,3 +26,6 @@ Gets the value of the specified column as an sbyte
 
 Gets the value of the specified column as a DateTimeOffset with an offset of 0
 ***
+`public ReadOnlyCollection<DbColumn> GetColumnSchema()`
+
+Implements the new [`IDbColumnSchemaGenerator.GetColumnSchema`](https://docs.microsoft.com/en-us/dotnet/api/system.data.common.idbcolumnschemagenerator.getcolumnschema) interface that returns metadata about the columns in the result set.

docs/content/connection-options.md

@@ -1,5 +1,5 @@
 ---
-lastmod: 2016-10-16
+lastmod: 2017-11-06
 date: 2016-10-16
 title: Connection Options
 weight: 30
@@ -22,32 +22,32 @@ These are the basic options that need to be defined to connect to a MySQL databa
   <thead>
     <th style="width: 20%">Name</th>
     <th style="width: 10%">Default</th>
-    <th style="width: 70%">Descriotion</th>
+    <th style="width: 70%">Description</th>
   </thead>
   <tr>
     <td>Host, Server, Data Source, DataSource, Address, Addr, Network Address</td>
     <td>localhost</td>
-    <td>The name or network address of the instance of MySQL to which to connect. Multiple hosts can be specified separated by commas. This can be useful where multiple MySQL servers are configured for replication and you are not concerned about the precise server you are connecting to. No attempt is made by the provider to synchronize writes to the database, so take care when using this option. In Unix environment with Mono, this can be a fully qualified path to a MySQL socket file. With this configuration, the Unix socket is used instead of the TCP/IP socket. Currently, only a single socket name can be given, so accessing MySQL in a replicated environment using Unix sockets is not currently supported.</td>
+    <td>The host name or network address of the MySQL Server to which to connect. Multiple hosts can be specified in a comma-delimited list.<br>On Unix-like systems, this can be a fully qualified path to a MySQL socket file, which will cause a Unix socket to be used instead of a TCP/IP socket. Only a single socket name can be specified.</td>
   </tr>
     <tr>
     <td>Port</td>
     <td>3306</td>
-    <td>The port MySQL is using to listen for connections.</td>
+    <td>The TCP port on which MySQL Server is listening for connections.</td>
   </tr>
   <tr>
     <td>User Id, UserID, Username, Uid, User name, User</td>
     <td></td>
-    <td>The MySQL login account being used.</td>
+    <td>The MySQL user ID.</td>
   </tr>
   <tr>
     <td>Password, pwd</td>
     <td></td>
-    <td>The password for the MySQL account being used.</td>
+    <td>The password for the MySQL user.</td>
   </tr>
   <tr>
     <td>Database, Initial Catalog</td>
     <td></td>
-    <td>The case-sensitive name of the database to use initially.  This is not required.</td>
+    <td>(Optional) The case-sensitive name of the initial database to use. This may be required if the MySQL user account only has access rights to particular databases on the server.</td>
   </tr>
 </table>
 
@@ -60,58 +60,58 @@ These are the options that need to be used in order to configure a connection to
   <thead>
     <th style="width: 20%">Name</th>
     <th style="width: 10%">Default</th>
-    <th style="width: 70%">Descriotion</th>
+    <th style="width: 70%">Description</th>
   </thead>
   <tr>
     <td>SSL Mode, SslMode</td>
     <td>Preferred</td>
     <td>This option has the following values:
       <ul>
-        <li><b>Preferred</b> - this is the default. Use SSL if the server supports it.</li>
-        <li><b>None</b> - do not use SSL.</li>
-        <li><b>Required</b> - Always use SSL. Deny connection if server does not support SSL.  Do not validate CA or hostname.</li>
-        <li><b>VerifyCA</b> - Always use SSL. Validate the CA but tolerate hostname mismatch.</li>
-        <li><b>VerifyFull</b> - Always use SSL. Validate CA and hostname.</li>
+        <li><b>Preferred</b> - (this is the default). Use SSL if the server supports it.</li>
+        <li><b>None</b> - Do not use SSL.</li>
+        <li><b>Required</b> - Always use SSL. Deny connection if server does not support SSL. Does not validate CA or hostname.</li>
+        <li><b>VerifyCA</b> - Always use SSL. Validates the CA but tolerates hostname mismatch.</li>
+        <li><b>VerifyFull</b> - Always use SSL. Validates CA and hostname.</li>
       </ul>
     </td>
   </tr>
   <tr>
     <td>Certificate File, CertificateFile</td>
     <td></td>
-    <td>This option specifies the path to a certificate file in a PEM Encoded (.pem) or PKCS #12 (.pfx) format. </td>
+    <td>Specifies the path to a certificate file in a PEM Encoded (.pem) or PKCS #12 (.pfx) format.</td>
   </tr>
   <tr>
     <td>Certificate Password, CertificatePassword	</td>
     <td></td>
-    <td>Specifies a password that is used in conjunction with a certificate specified using the option CertificateFile.  Not required if the certificate file is not password protected.</td>
+    <td>Specifies the password for the certificate specified using the <code>CertificateFile</code> option. Not required if the certificate file is not password protected.</td>
   </tr>
   <tr>
     <td>CA Certificate File, CACertificateFile</td>
     <td></td>
-    <td>This option specifies the path to a CA certificate file in a PEM Encoded (.pem) format.  This should be used in with <code>SslMode=VerifyCA</code> or <code>SslMode=VerifyFull</code> to enable verification of a CA certificate that is not trusted by the Operating System's certificate store.</td>
+    <td>This option specifies the path to a CA certificate file in a PEM Encoded (.pem) format. This should be used in with <code>SslMode=VerifyCA</code> or <code>SslMode=VerifyFull</code> to enable verification of a CA certificate that is not trusted by the Operating System's certificate store.</td>
   </tr>
 </table>
 
 Connection Pooling Options
 --------------------------
 
-Connection pooling is enabled by default.  These options are used to configure it.
+Connection pooling is enabled by default. These options are used to configure it.
 
 <table class="table table-striped table-hover">
   <thead>
     <th style="width: 20%">Name</th>
     <th style="width: 10%">Default</th>
-    <th style="width: 70%">Descriotion</th>
+    <th style="width: 70%">Description</th>
   </thead>
   <tr>
     <td>Pooling</td>
     <td>true</td>
-    <td>When true, the MySqlConnection object is drawn from the appropriate pool, or if necessary, is created and added to the appropriate pool. Recognized values are true, false, yes, and no.</td>
+    <td>Enables connection pooling. When pooling is enabled, <code>MySqlConnection.Open</code> retrieves an open connection from the pool if one is available (opening a new connection if not), and <code>Close</code>/<code>Dispose</code> returns the open connection to the pool.</td>
   </tr>
   <tr>
     <td>Connection Lifetime, ConnectionLifeTime</td>
     <td>0</td>
-    <td>When a connection is returned to the pool, its creation time is compared with the current time, and the connection is destroyed if that time span (in seconds) exceeds the value specified by Connection Lifetime. This is useful in clustered configurations to force load balancing between a running server and a server just brought online. A value of zero (0) means pooled connections will never incur a ConnectionLifeTime timeout.</td>
+    <td>Controls the maximum length of time a connection to the server can be open. Connections that are returned to the pool are destroyed if it's been more than <code>ConnectionLifeTime</code> seconds since the connection was created. The default value of zero (0) means pooled connections will never incur a ConnectionLifeTime timeout.</td>
   </tr>
   <tr>
     <td>Connection Reset, ConnectionReset	</td>
@@ -121,7 +121,7 @@ Connection pooling is enabled by default.  These options are used to configure i
   <tr>
     <td>Connection Idle Timeout, ConnectionIdleTimeout</td>
     <td>180</td>
-    <td>The amount of time in seconds that a connection can remain idle in the pool. Any connection that is idle for longer is subject to being closed by a background task that runs every minute, unless there are only MinimumPoolSize connections left in the pool. A value of zero (0) means pooled connections will never incur a ConnectionIdleTimeout.</td>
+    <td>The amount of time in seconds that a connection can remain idle in the pool. Any connection that is idle for longer is subject to being closed by a background task that runs every minute, unless there are only MinimumPoolSize connections left in the pool. A value of zero (0) means pooled connections will never incur a ConnectionIdleTimeout, and if the pool grows to its maximum size, it will never get smaller.</td>
   </tr>
   <tr>
     <td>Maximum Pool Size, Max Pool Size, MaximumPoolsize, maxpoolsize</td>
@@ -138,13 +138,13 @@ Connection pooling is enabled by default.  These options are used to configure i
 Other Options
 -------------
 
-These are the other options that MySqlConnector supports.  They are set to sensible defaults and typically do not need to be tweaked.
+These are the other options that MySqlConnector supports. They are set to sensible defaults and typically do not need to be tweaked.
 
 <table class="table table-striped table-hover">
   <thead>
     <th style="width: 20%">Name</th>
     <th style="width: 10%">Default</th>
-    <th style="width: 70%">Descriotion</th>
+    <th style="width: 70%">Description</th>
   </thead>
   <tr>
     <td>AllowPublicKeyRetrieval, Allow Public Key Retrieval</td>
@@ -157,7 +157,8 @@ These are the other options that MySqlConnector supports.  They are set to sensi
   <tr>
     <td>AllowUserVariables, Allow User Variables</td>
     <td>false</td>
-    <td>Setting this to true indicates that the provider expects user variables in the SQL.</td>
+    <td>Allows user-defined variables (prefixed with <code>@</code>) to be used in SQL statements. The default value (<code>false</code>)
+    only allows <code>@</code>-prefixed names to refer to command parameters.</td>
   </tr>
   <tr>
     <td>Compress, Use Compression, UseCompression</td>
@@ -186,7 +187,7 @@ These are the other options that MySqlConnector supports.  They are set to sensi
   <tr>
     <td>Keep Alive, Keepalive</td>
     <td>0</td>
-    <td>TCP Keepalive idle time.  A value of 0 indicates that the OS Default keepalive settings are used.
+    <td>TCP Keepalive idle time. A value of 0 indicates that the OS Default keepalive settings are used.
     On Windows, a value greater than 0 is the idle connection time, measured in seconds, before the first keepalive packet is sent.
     Due to limitations in .NET Core, Unix-based Operating Systems will always use the OS Default keepalive settings.</td>
   </tr>
@@ -224,7 +225,7 @@ These are the other options that MySqlConnector supports.  They are set to sensi
   <tr>
     <td>Treat Tiny As Boolean, TreatTinyAsBoolean</td>
     <td>true</td>
-    <td>When set to true, tinyint(1) values are returned as booleans.  Setting this to false causes tinyint(1) to be returned as sbyte/byte.</td>
+    <td>When set to true, tinyint(1) values are returned as booleans. Setting this to false causes tinyint(1) to be returned as sbyte/byte.</td>
   </tr>
   <tr>
     <td>Use Affected Rows, UseAffectedRows</td>

docs/content/home.md

@@ -1,5 +1,5 @@
 ---
-lastmod: 2016-10-16
+lastmod: 2017-11-06
 date: 2016-10-16
 title: Home
 weight: 10
@@ -15,7 +15,7 @@ Home
 MySqlConnector is an [ADO.NET](https://msdn.microsoft.com/en-us/library/e80y5yhx.aspx) data
 provider for [MySQL](https://www.mysql.com/). It provides implementations of
 `DbConnection`, `DbCommand`, `DbDataReader`, `DbTransaction` – the classes
-needed to query and update databases from managed code.  Its features include:
+needed to query and update databases from managed code. Its features include:
 
 * .NET Core Compatibility
 * Truly Asynchronous: async functions implement asynchronous I/O
@@ -47,7 +47,7 @@ and is not based on [Oracle's Connector/NET](https://github.com/mysql/mysql-conn
       <a href="https://github.com/mysql-net/MySqlConnector">GitHub</a>
     </td>
     <td>
-      Closed Development Roadmap.  Code is viewable on
+      Closed Development Roadmap. Code is viewable on
       <a href="https://github.com/mysql/mysql-connector-net">GitHub</a>,
       some issues addressed in <a href="http://forums.mysql.com/list.php?38">Forums</a>
     </td>

docs/content/overview/installing.md

@@ -1,5 +1,5 @@
 ---
-lastmod: 2017-10-21
+lastmod: 2017-11-06
 date: 2016-10-16
 menu:
   main:
@@ -11,7 +11,15 @@ weight: 10
 Installing
 ==========
 
-The recommended way of installing MySqlConnector is through [NuGet](https://www.nuget.org/packages/MySqlConnector/)
+The recommended way of installing MySqlConnector is through [NuGet](https://www.nuget.org/packages/MySqlConnector/).
+
+### Automatically
+
+If using the new project system, run: `dotnet add package MySqlConnector`
+
+Or, in Visual Studio, use the _NuGet Package Manager_ to browse for and install `MySqlConnector`.
+
+### Manually
 
 **Step 1:** Add MySqlConnector to the dependencies in your `csproj` file:
 
@@ -25,7 +33,7 @@ The recommended way of installing MySqlConnector is through [NuGet](https://www.
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="MySqlConnector" Version="0.28.2" />
+    <PackageReference Include="MySqlConnector" Version="0.30.0" />
   </ItemGroup>
 
 </Project>

docs/content/overview/known-issues.md

@@ -1,5 +1,5 @@
 ---
-lastmod: 2017-03-27
+lastmod: 2017-11-06
 date: 2017-03-27
 menu:
   main:
@@ -12,5 +12,4 @@ Known Issues
 ============
 
 * Not all MySQL data types are supported.
-* Many `MySql.Data` connection string settings are not supported by this library. See [Connection Options](connection-options/) for a list of supported options.
-* Only the `mysql_native_password` and `mysql_old_password` authentication plugins are supported.
+* Some `MySql.Data` connection string settings are not supported by this library. See [Connection Options](connection-options/) for a list of supported options.

docs/content/overview/use-with-orms.md

@@ -1,5 +1,5 @@
 ---
-lastmod: 2016-10-16
+lastmod: 2017-11-06
 date: 2016-10-16
 menu:
   main:
@@ -15,6 +15,7 @@ This library is compatible with popular .NET ORMs including:
 
 * [Dapper](https://github.com/StackExchange/dapper-dot-net) ([NuGet](https://www.nuget.org/packages/Dapper))
 * [NReco.Data](https://github.com/nreco/data) ([NuGet](https://www.nuget.org/packages/NReco.Data))
+* [ServiceStack.OrmLite](https://github.com/ServiceStack/ServiceStack.OrmLite) ([MyGet](https://www.myget.org/feed/servicestack/package/nuget/ServiceStack.OrmLite.MySqlConnector))
 * [SimpleStack.Orm](https://github.com/SimpleStack/simplestack.orm) ([NuGet](https://www.nuget.org/packages/SimpleStack.Orm.MySQLConnector))
 
 For Entity Framework support, use:

docs/content/tutorials/best-practices.md

@@ -1,5 +1,5 @@
 ---
-lastmod: 2017-10-21
+lastmod: 2017-11-06
 date: 2016-10-16
 menu:
   main:
@@ -14,7 +14,7 @@ Best Practices
 ## Asynchronous Operation
 
 MySqlConnector is fully asynchronous, supporting the async ADO.NET methods added in .NET 4.5 without blocking
-or using `Task.Run` to run synchronous methods on a background thread.  Programmers implementing MySqlConnector
+or using `Task.Run` to run synchronous methods on a background thread. Programmers implementing MySqlConnector
 should be familiar with [Async/Await - Best Practices in Asynchronous Programming](https://msdn.microsoft.com/en-us/magazine/jj991977.aspx).
 
 ### Always Use Async when possible
@@ -98,7 +98,7 @@ uses cached `Task<bool>` objects for its `true` and `false` return values.)
 ### Example Console Application
 
 In order to get the full benefit of asynchronous operation, every method in the call stack that eventually calls
-MySqlConnector should be implemented as an async method.  The exception is the `static void Main` method in a Console Application.
+MySqlConnector should be implemented as an async method.
 
 Example assumes a [configured AppDb](overview/configuration) object in the `MySqlConnector.Examples` namespace.
 
@@ -110,15 +110,11 @@ namespace MySqlConnector.Examples
 {
     public class Program
     {
-        public static void Main(string[] args)
-        {
-            MainAsync(args).GetAwaiter().GetResult();
-        }
-
-        public static async Task MainAsync(string[] args)
+        public static async Task Main(string[] args)
         {
             var tasks = new List<Task>();
-            for (var i=0; i<100; i++){
+            for (var i=0; i<100; i++)
+            {
                 tasks.Add(Controllers.SleepOne());
             }
             // these 100 queries should all complete in around
@@ -150,11 +146,11 @@ namespace MySqlConnector.Examples
 
 <div class="alert alert-warning">
   Using Synchronous Methods can have adverse effects on the managed thread pool and cause slowdowns or lock-ups
-  if not properly tuned.  The recommended approach is to use all Asynchronous Methods.
+  if not properly tuned. The recommended approach is to use all Asynchronous Methods.
 </div>
 
 If you must use synchronous methods, ensure that your thread pool is at least the size of the number of
-concurrent connections you plan to support.  For example, if you are creating a web server using
+concurrent connections you plan to support. For example, if you are creating a web server using
 synchronous methods that needs to support serving 500 Requests Per Second, set the minimum thread
 pool size to 500.