Tidy up toctree (#7441)

Attempt to tidy up the toctree

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

docs/client.rst

@@ -10,6 +10,7 @@ The page contains all information about aiohttp Client API:
 
 .. toctree::
    :name: client
+   :maxdepth: 3
 
    Quickstart <client_quickstart>
    Advanced Usage <client_advanced>

docs/client_reference.rst

@@ -941,9 +941,6 @@ By default all *connectors* support *keep-alive connections* (behavior
 is controlled by *force_close* constructor's parameter).
 
 
-BaseConnector
-^^^^^^^^^^^^^
-
 .. class:: BaseConnector(*, keepalive_timeout=15, \
                          force_close=False, limit=100, limit_per_host=0, \
                          enable_cleanup_closed=False, loop=None)
@@ -1033,11 +1030,6 @@ BaseConnector
       overridden in subclasses.
 
 
-
-
-TCPConnector
-^^^^^^^^^^^^
-
 .. class:: TCPConnector(*, ssl=None, verify_ssl=True, fingerprint=None, \
                  use_dns_cache=True, ttl_dns_cache=10, \
                  family=0, ssl_context=None, local_addr=None, \
@@ -1173,9 +1165,6 @@ TCPConnector
       clear all cache otherwise.
 
 
-UnixConnector
-^^^^^^^^^^^^^
-
 .. class:: UnixConnector(path, *, conn_timeout=None, \
                          keepalive_timeout=30, limit=100, \
                          force_close=False, loop=None)
@@ -1208,9 +1197,6 @@ UnixConnector
       Path to *UNIX socket*, read-only :class:`str` property.
 
 
-Connection
-^^^^^^^^^^
-
 .. class:: Connection
 
    Encapsulates single connection in connector object.
@@ -1696,9 +1682,6 @@ Utilities
 ---------
 
 
-ClientTimeout
-^^^^^^^^^^^^^
-
 .. class:: ClientTimeout(*, total=None, connect=None, \
                          sock_connect=None, sock_read=None)
 
@@ -1764,9 +1747,6 @@ ClientTimeout
          on production environment.
 
 
-ETag
-^^^^
-
 .. class:: ETag(name, is_weak=False)
 
    Represents `ETag` identifier.
@@ -1781,8 +1761,6 @@ ETag
 
    .. versionadded:: 3.8
 
-RequestInfo
-^^^^^^^^^^^
 
 .. class:: RequestInfo()
 
@@ -1808,9 +1786,6 @@ RequestInfo
       .. versionadded:: 3.2
 
 
-BasicAuth
-^^^^^^^^^
-
 .. class:: BasicAuth(login, password='', encoding='latin1')
 
    HTTP basic authentication helper.
@@ -1851,9 +1826,6 @@ BasicAuth
       :return: encoded authentication data, :class:`str`.
 
 
-CookieJar
-^^^^^^^^^
-
 .. class:: CookieJar(*, unsafe=False, quote_cookie=True, treat_as_secure_origin = [])
 
    The cookie jar instance is available as :attr:`ClientSession.cookie_jar`.

docs/tracing_reference.rst

@@ -121,9 +121,8 @@ DNS resolving
    }
 
 
-TraceConfig
------------
-
+Classes
+-------
 
 .. class:: TraceConfig(trace_config_ctx_factory=SimpleNamespace)
 
@@ -278,8 +277,6 @@ TraceConfig
 
       .. versionadded:: 3.8
 
-TraceRequestStartParams
------------------------
 
 .. class:: TraceRequestStartParams
 
@@ -298,9 +295,6 @@ TraceRequestStartParams
        Headers that will be used for the request, can be mutated.
 
 
-TraceRequestChunkSentParams
----------------------------
-
 .. class:: TraceRequestChunkSentParams
 
    .. versionadded:: 3.1
@@ -320,9 +314,6 @@ TraceRequestChunkSentParams
        Bytes of chunk sent
 
 
-TraceResponseChunkReceivedParams
---------------------------------
-
 .. class:: TraceResponseChunkReceivedParams
 
    .. versionadded:: 3.1
@@ -342,9 +333,6 @@ TraceResponseChunkReceivedParams
        Bytes of chunk received
 
 
-TraceRequestEndParams
----------------------
-
 .. class:: TraceRequestEndParams
 
    See :attr:`TraceConfig.on_request_end` for details.
@@ -366,9 +354,6 @@ TraceRequestEndParams
        Response :class:`ClientResponse`.
 
 
-TraceRequestExceptionParams
----------------------------
-
 .. class:: TraceRequestExceptionParams
 
    See :attr:`TraceConfig.on_request_exception` for details.
@@ -389,8 +374,6 @@ TraceRequestExceptionParams
 
        Exception raised during the request.
 
-TraceRequestRedirectParams
---------------------------
 
 .. class:: TraceRequestRedirectParams
 
@@ -412,53 +395,41 @@ TraceRequestRedirectParams
 
        Response :class:`ClientResponse` got from the redirect.
 
-TraceConnectionQueuedStartParams
---------------------------------
 
 .. class:: TraceConnectionQueuedStartParams
 
    See :attr:`TraceConfig.on_connection_queued_start` for details.
 
    There are no attributes right now.
 
-TraceConnectionQueuedEndParams
-------------------------------
 
 .. class:: TraceConnectionQueuedEndParams
 
    See :attr:`TraceConfig.on_connection_queued_end` for details.
 
    There are no attributes right now.
 
-TraceConnectionCreateStartParams
---------------------------------
 
 .. class:: TraceConnectionCreateStartParams
 
    See :attr:`TraceConfig.on_connection_create_start` for details.
 
    There are no attributes right now.
 
-TraceConnectionCreateEndParams
-------------------------------
 
 .. class:: TraceConnectionCreateEndParams
 
    See :attr:`TraceConfig.on_connection_create_end` for details.
 
    There are no attributes right now.
 
-TraceConnectionReuseconnParams
-------------------------------
 
 .. class:: TraceConnectionReuseconnParams
 
    See :attr:`TraceConfig.on_connection_reuseconn` for details.
 
    There are no attributes right now.
 
-TraceDnsResolveHostStartParams
-------------------------------
 
 .. class:: TraceDnsResolveHostStartParams
 
@@ -468,8 +439,6 @@ TraceDnsResolveHostStartParams
 
        Host that will be resolved.
 
-TraceDnsResolveHostEndParams
-----------------------------
 
 .. class:: TraceDnsResolveHostEndParams
 
@@ -479,8 +448,6 @@ TraceDnsResolveHostEndParams
 
        Host that has been resolved.
 
-TraceDnsCacheHitParams
-----------------------
 
 .. class:: TraceDnsCacheHitParams
 
@@ -490,8 +457,6 @@ TraceDnsCacheHitParams
 
        Host found in the cache.
 
-TraceDnsCacheMissParams
------------------------
 
 .. class:: TraceDnsCacheMissParams
 
@@ -501,8 +466,6 @@ TraceDnsCacheMissParams
 
        Host didn't find the cache.
 
-TraceRequestHeadersSentParams
------------------------------
 
 .. class:: TraceRequestHeadersSentParams
 

docs/utilities.rst

@@ -9,6 +9,7 @@ Miscellaneous API Shared between Client And Server.
 
 .. toctree::
    :name: utilities
+   :maxdepth: 2
 
    abc
    multipart

docs/web.rst

@@ -10,6 +10,7 @@ The page contains all information about aiohttp Server API:
 
 .. toctree::
    :name: server
+   :maxdepth: 3
 
    Tutorial <https://demos.aiohttp.org>
    Quickstart <web_quickstart>