Python-guidelines.md

@@ -3,8 +3,7 @@ Welcome to the Python guidelines we use for network-health code. Below is a list
 Conventions and tools we use
 ----------------------------
 
-Style
-"""""
+### Style
 
 Conventions:
 
@@ -26,8 +25,7 @@ Tools to use to automatically test style and/or fix it.
 - [flake8-docstring](https://pypi.org/project/flake8-docstrings/):
   follows PEP257.
 
-Documentation
-"""""""""""""
+### Documentation
 
 Tools:
 
@@ -35,8 +33,7 @@ Tools:
 - [Sphinx](https://www.sphinx-doc.org/): makes it easy to create intelligent
   and beautiful documentation.
 
-Testing
-"""""""
+### Testing
 
 - [pytests](https://pytest.org): makes it easy to write small tests.
 - [tox](https://tox.readthedocs.io/): virtualenv-based automation of test
@@ -45,8 +42,7 @@ Testing
 - [coverage](https://coverage.readthedocs.io/): a tool for measuring code
   coverage of Python programs. [Example configuration](https://gitlab.torproject.org/juga/python_template_minimal/-/blob/main/.coveragerc)
 
-Packaging
-"""""""""
+### Packaging
 
 In general, develop with last versions of the dependencies.
 When packaging, ensure your application works with older stable dependencies.
@@ -66,8 +62,7 @@ See also: [install requires vs requirements](https://packaging.python.org/discus
 Other conventions and tools
 ---------------------------
 
-Style
-"""""
+### Style
 
 - [isort](https://pycqa.github.io/isort/): sort imports alphabetically and
   automatically separated into sections and by type.