Merge branch 'bug_40036_v3' into 'maint-1.1'

fix: doc: Sphinx warnings when creating documentation

Closes #40036

See merge request tpo/network-health/sbws!54

AUTHORS.md

-# Authors
+Authors
+=======
 
 The following people have contributed to Simple Bandwidth Scanner.
 Thank you for helping make Tor better.

README.md

-# Readme
+Readme
+======
 
 [![Build Status](https://travis-ci.org/torproject/sbws.svg?branch=master)](https://travis-ci.org/https://travis-ci.org/torproject/sbws)
 

docs/source/conf.py

@@ -97,7 +97,7 @@ html_theme = 'nature'
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+html_static_path = []
 
 # Custom sidebar templates, must be a dictionary that maps document names
 # to template names.

docs/source/torflow_aggr.rst

@@ -426,4 +426,4 @@ oldest measurements are 5 days old::
 .. _SQLSupport.py: https://gitweb.torproject.org/pytorctl.git/tree/SQLSupport.py#n493
 .. _bandwidth file spec: https://gitweb.torproject.org/torspec.git/tree/bandwidth-file-spec.txt
 .. _aggregate.py: https://gitweb.torproject.org/torflow.git/tree/NetworkScanners/BwAuthority/aggregate.py
-.. _TorCtly.py: https://gitweb.torproject.org/pytorctl.git/tree/TorCtl.py
+.. _TorCtl.py: https://gitweb.torproject.org/pytorctl.git/tree/TorCtl.py

sbws/lib/relaylist.py

@@ -24,6 +24,7 @@ def valid_after_from_network_statuses(network_statuses):
     attribute of a ``stem.descriptor.RouterStatusEntryV3``.
 
     :param list network_statuses:
+
     returns datetime:
     """
     for ns in network_statuses:
@@ -228,7 +229,7 @@ class Relay:
         Increment The number of times that a relay has been queued
         to be measured.
 
-        It is call from :funf:`~sbws.core.scaner.main_loop`.
+        It is call from :func:`~sbws.core.scaner.main_loop`.
         """
         self.relay_recent_measurement_attempt.update()
 
@@ -468,7 +469,7 @@ class RelayList:
         Increment the number of times that any relay has been queued to be
         measured.
 
-        It is call from :funf:`~sbws.core.scaner.main_loop`.
+        It is call from :func:`~sbws.core.scaner.main_loop`.
 
         It is read and stored in a ``state`` file.
         """

sbws/lib/relayprioritizer.py

@@ -97,6 +97,7 @@ class RelayPrioritizer:
             measurements that did not succed.
         :param bool return_fraction: whether to return only a fraction of the
             relays seen in the network or return all.
+
         return: a generator of the new ordered list of relays to measure next.
 
         """

sbws/lib/resultdump.py

@@ -558,7 +558,7 @@ class ResultErrorSecondRelay(ResultError):
 
     A second suitable relay is a relay that:
     - Has at least equal bandwidth as the relay to measure.
-    - If the relay to measure is not an exit,
+    - If the relay to measure is not an exit, \
       the second relay is an exit without `bad` flag and can exit to port 443.
     - If the relay to measure is an exit, the second relay is not an exit.
 

sbws/lib/v3bwfile.py

@@ -625,7 +625,7 @@ class V3BWLine(object):
     :param dict kwargs: extra headers.
 
     .. note:: tech-debt: move node_id and bw to kwargs and just ensure that
-       the required values are in **kwargs
+       the required values are in ``**kwargs``
     """
     def __init__(self, node_id, bw, **kwargs):
         assert isinstance(node_id, str)

sbws/util/stem.py

@@ -118,7 +118,8 @@ def parse_user_torrc_config(torrc, torrc_text):
     """Parse the user configuration torrc text call `extra_lines`
     to a dictionary suitable to use with stem and return a new torrc
     dictionary that merges that dictionary with the existing torrc.
-    Example:
+    Example::
+
         [tor]
         extra_lines =
             Log debug file /tmp/tor-debug.log