Document logging. Fixes #417

Author: bgrainger

docs/UsingLog4netLogging.md

@@ -0,0 +1,7 @@
+## How to Use
+
+To integrate MySqlConnector with log4net, add the following line of code to your application startup routine (before any `MySqlConnector` objects have been used):
+
+```
+MySqlConnectorLogManager.Provider = new Log4netLoggerProvider();
+```

docs/UsingMicrosoftExtensionsLogging.md

@@ -0,0 +1,7 @@
+## How to Use
+
+To integrate MySqlConnector with Microsoft.Extensions.Logging, add the following line of code to your `Startup.Configure` method (before any `MySqlConnector` objects have been used):
+
+```
+MySqlConnectorLogManager.Provider = new MicrosoftExtensionsLoggingLoggerProvider(loggerFactory);
+```

docs/content/overview/logging.md

@@ -0,0 +1,37 @@
+---
+date: 2018-01-20
+menu:
+  main:
+    parent: getting started
+title: Logging
+weight: 50
+---
+
+Logging
+=======
+
+MySqlConnector implements a custom logging framework with the `IMySqlConnectorLogger` and `IMySqlConnectorLoggerProvider` interfaces.
+To connect MySqlConnector to an existing logging framework, write an implementation of `IMySqlConnectorLoggerProvider` that adapts
+the existing logging framework, and install it by setting `MySqlConnector.Logging.MySqlConnectorLogManager.Provider = provider;`.
+
+The `MySqlConnectorLogManager.Provider` property may only be set once, and must be set before any other MySqlConnector library methods are called.
+
+### Existing Logging Providers
+
+There are NuGet packages that adapt MySqlConnetor logging for popular logging frameworks.
+
+#### log4net
+
+Install [MySqlConnector.Logging.log4net](https://www.nuget.org/packages/MySqlConnector.Logging.log4net/).
+
+Add the following line of code to your application startup routine:
+
+    MySqlConnectorLogManager.Provider = new Log4netLoggerProvider();
+
+#### Microsoft.Extensions.Logging
+
+Install [MySqlConnector.Logging.Microsoft.Extensions.Logging](https://www.nuget.org/packages/MySqlConnector.Logging.Microsoft.Extensions.Logging/).
+
+Add the following line of code to your `Startup.Configure` method:
+
+    MySqlConnectorLogManager.Provider = new MicrosoftExtensionsLoggingLoggerProvider(loggerFactory);

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

@@ -5,7 +5,7 @@ menu:
   main:
     parent: getting started
 title: Use with ORMs
-weight: 50
+weight: 60
 ---
 
 Use with ORMs