docs/extend: reformat notes

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

docs/extend/index.md

@@ -24,8 +24,9 @@ plugins using Docker Engine.
 For information about the legacy plugin system available in Docker Engine 1.12
 and earlier, see [Understand legacy Docker Engine plugins](legacy_plugins.md).
 
-> **Note**: Docker Engine managed plugins are currently not supported
+> **Note**
-on Windows daemons.
+>
+> Docker Engine managed plugins are currently not supported on Windows daemons.
 
 ## Installing and using a plugin
 
@@ -45,7 +46,12 @@ operation, such as creating a volume.
 In the following example, you install the `sshfs` plugin, verify that it is
 enabled, and use it to create a volume.
 
-> **Note**: This example is intended for instructional purposes only. Once the volume is created, your SSH password to the remote host will be exposed as plaintext when inspecting the volume. You should delete the volume as soon as you are done with the example.
+> **Note**
+>
+> This example is intended for instructional purposes only. Once the volume is
+> created, your SSH password to the remote host will be exposed as plaintext
+> when inspecting the volume. You should delete the volume as soon as you are
+> done with the example.
 
 1.  Install the `sshfs` plugin.
 

docs/extend/plugins_authorization.md

@@ -53,8 +53,10 @@ Authorization plugins must follow the rules described in [Docker Plugin API](plu
 Each plugin must reside within directories described under the
 [Plugin discovery](plugin_api.md#plugin-discovery) section.
 
-**Note**: the abbreviations `AuthZ` and `AuthN` mean authorization and authentication
+> **Note**
-respectively.
+>
+> The abbreviations `AuthZ` and `AuthN` mean authorization and authentication
+> respectively.
 
 ## Default user authorization mechanism
 

docs/extend/plugins_metrics.md

@@ -18,9 +18,11 @@ Docker exposes internal metrics based on the prometheus format. Metrics plugins
 enable accessing these metrics in a consistent way by providing a Unix
 socket at a predefined path where the plugin can scrape the metrics.
 
-> **Note**: that while the plugin interface for metrics is non-experimental, the naming
+> **Note**
-of the metrics and metric labels is still considered experimental and may change
+>
-in a future version.
+> While the plugin interface for metrics is non-experimental, the naming of the
+> metrics and metric labels is still considered experimental and may change in a
+> future version.
 
 ## Creating a metrics plugin
 

docs/extend/plugins_volume.md

@@ -90,9 +90,11 @@ provide the Docker Daemon with writeable paths on the host filesystem. The Docke
 daemon provides these paths to containers to consume. The Docker daemon makes
 the volumes available by bind-mounting the provided paths into the containers.
 
-> **Note**: Volume plugins should *not* write data to the `/var/lib/docker/`
+> **Note**
-> directory, including `/var/lib/docker/volumes`. The `/var/lib/docker/`
+>
-> directory is reserved for Docker.
+> Volume plugins should *not* write data to the `/var/lib/docker/` directory,
+> including `/var/lib/docker/volumes`. The `/var/lib/docker/` directory is
+> reserved for Docker.
 
 ### `/VolumeDriver.Create`