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

[Adam Collard]

Remove redundant tocdepth from api-docs.

[Alberto Donato (ack)]

+1 with a nit

review: Approve

[MAAS Lander (maas-lander)]

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

STATUS: FAILED BUILD
LOG: http://maas-ci.internal:8080/job/maas/job/branch-tester/9158/consoleText

4cbe04c... by Adam Collard on 2021-02-03

Remove unused import

Signed-off-by: Adam Collard <email address hidden>

diff --git a/src/maasserver/api/doc_handler.py b/src/maasserver/api/doc_handler.py
index 6425110..9b332c7 100644
--- a/src/maasserver/api/doc_handler.py
+++ b/src/maasserver/api/doc_handler.py
@@ -80,7 +80,6 @@ from maasserver.utils import build_absolute_uri
 # the two.
 api_doc_title = dedent(
     """
-    :tocdepth: 3
     .. _maas-api:
 
     ========
diff --git a/src/maasserver/tests/test_commands.py b/src/maasserver/tests/test_commands.py
index ce906c9..1b98b9d 100644
--- a/src/maasserver/tests/test_commands.py
+++ b/src/maasserver/tests/test_commands.py
@@ -12,7 +12,7 @@ from django.contrib.auth.models import User
 from django.core.management import call_command
 from django.core.management.base import CommandError
 from requests.exceptions import RequestException
-from testtools.matchers import AfterPreprocessing, HasLength, StartsWith
+from testtools.matchers import AfterPreprocessing, HasLength
 
 from apiclient.creds import convert_tuple_to_string
 from maasserver.enum import KEYS_PROTOCOL_TYPE
@@ -57,15 +57,11 @@ class TestCommands(MAASServerTestCase):
         # Just check that the documentation looks all right.
         self.assertIn("POST /MAAS/api/2.0/account/", result)
         self.assertIn("MAAS API", result)
-        # The documentation starts with a link target: "region-controller-api".
-        # (And also a specification that the left-side table-of-contents depth
-        # should not exceed 3 levels deep.)
-        self.assertThat(
-            result[:100],
-            StartsWith(":tocdepth: 3\n.. _maas-api:"),
+        self.assertTrue(
+            result[:20].startswith(".. _maas-api:"),
         )
         # It also contains a ReST title (not indented).
-        self.assertIn("===", result[:100])
+        self.assertIn("===", result[:20])
 
     def test_createadmin_prompts_for_password_if_not_given(self):
         stderr = StringIO()