Merge ~adam-collard/maas:api-docs-reformat into maas:master

[Adam Collard]

Fix whitespace in API documentation

Leading whitespace in the docstrings themselves cause <blockquote /> in the
HTML output which is undesirable.

Missing break at the start of class docstrings causes false
indentation, again causing <blockquote /> in HTML.

[Alberto Donato (ack)]

+1

review: Approve

[MAAS Lander (maas-lander)]

UNIT TESTS
-b api-docs-reformat lp:~adam-collard/maas/+git/maas into -b master lp:~maas-committers/maas

STATUS: SUCCESS
COMMIT: 63616417ef6bc880ae5d4fdb9b316de22724e173

review: Approve

diff --git a/src/maasserver/api/commissioning_scripts.py b/src/maasserver/api/commissioning_scripts.py
index 6a513ce..443a280 100644
--- a/src/maasserver/api/commissioning_scripts.py
+++ b/src/maasserver/api/commissioning_scripts.py
@@ -30,7 +30,8 @@ def get_content_parameter(request):
 
 
 class CommissioningScriptsHandler(OperationsHandler):
-    """Manage custom commissioning scripts.
+    """
+    Manage custom commissioning scripts.
 
     This functionality is only available to administrators.
 
@@ -111,7 +112,8 @@ class CommissioningScriptsHandler(OperationsHandler):
 
 
 class CommissioningScriptHandler(OperationsHandler):
-    """Manage a custom commissioning script.
+    """
+    Manage a custom commissioning script.
 
     This functionality is only available to administrators.
 
diff --git a/src/maasserver/api/networks.py b/src/maasserver/api/networks.py
index d313cd5..d166f9a 100644
--- a/src/maasserver/api/networks.py
+++ b/src/maasserver/api/networks.py
@@ -40,7 +40,8 @@ def render_networks_json(subnets):
 
 
 class NetworkHandler(OperationsHandler):
-    """Manage a network.
+    """
+    Manage a network.
 
     This endpoint is deprecated. Use the new 'subnet' endpoint instead.
     """
@@ -147,7 +148,8 @@ class NetworkHandler(OperationsHandler):
 
 
 class NetworksHandler(OperationsHandler):
-    """Manage the networks.
+    """
+    Manage the networks.
 
     This endpoint is deprecated. Use the new 'subnets' endpoint instead.
     """
diff --git a/src/maasserver/api/ssh_keys.py b/src/maasserver/api/ssh_keys.py
index 0c2e875..4692f82 100644
--- a/src/maasserver/api/ssh_keys.py
+++ b/src/maasserver/api/ssh_keys.py
@@ -56,7 +56,7 @@ class SSHKeysHandler(OperationsHandler):
         should be provided in the request payload as form data with the name
         'key':
 
-            key: "key-type public-key-data"
+        ``key: "key-type public-key-data"``
 
         - ``key-type``: ecdsa-sha2-nistp256, ecdsa-sha2-nistp384,
           ecdsa-sha2-nistp521, ssh-dss, ssh-ed25519, ssh-rsa
@@ -112,7 +112,7 @@ class SSHKeysHandler(OperationsHandler):
 
         E.g.
 
-            source:user
+        ``source:user``
 
         - ``source``: lp (Launchpad), gh (GitHub)
         - ``user``: User login
diff --git a/src/maasserver/api/ssl_keys.py b/src/maasserver/api/ssl_keys.py
index 3c03a8c..da19023 100644
--- a/src/maasserver/api/ssl_keys.py
+++ b/src/maasserver/api/ssl_keys.py
@@ -50,7 +50,7 @@ class SSLKeysHandler(OperationsHandler):
         should be provided in the request payload as form data with the name
         'key':
 
-            key: "key data"
+        ``key: "key data"``
 
         - ``key data``: The contents of a pem file.
 
diff --git a/src/maasserver/api/tmpl-apidoc.rst b/src/maasserver/api/tmpl-apidoc.rst
index 1d2c3e5..7568a7c 100644
--- a/src/maasserver/api/tmpl-apidoc.rst
+++ b/src/maasserver/api/tmpl-apidoc.rst
@@ -1,7 +1,7 @@
 .. raw:: html
 
   <details>
-    <summary><code>{{ http_method }} {{ uri }}{{if operation != ""}}?{{ operation }}{{endif}}</code></summary>
+  <summary><code>{{ http_method }} {{ uri }}{{if operation != ""}}?{{ operation }}{{endif}}</code></summary>
 
 {{py:
 params_length = len(params)