realpython · mpoulin · Dec 5, 2018 · Dec 4, 2018
diff --git a/docs/intro/community.rst b/docs/intro/community.rst
@@ -7,16 +7,19 @@ The Community
 
 .. image:: /_static/photos/34689432801_78d97ecec9_k_d.jpg
 
+
+****
 BDFL
-----
+****
 
 Guido van Rossum, the creator of Python, is often referred to as the BDFL — the
 Benevolent Dictator For Life.
 
 
-
+**************************
 Python Software Foundation
---------------------------
+**************************
+
 
 The mission of the Python Software Foundation is to promote, protect, and
 advance the Python programming language, and to support and facilitate the
@@ -25,8 +28,9 @@ growth of a diverse and international community of Python programmers.
 `Learn More about the PSF <http://www.python.org/psf/>`_.
 
 
+****
 PEPs
-----
+****
 
 PEPs are *Python Enhancement Proposals*. They describe changes to Python itself,
 or the standards around it.
@@ -72,8 +76,9 @@ Here's an overview of the PEP acceptance workflow:
 .. image:: ../_static/pep-0001-1.png
 
 
+******************
 Python Conferences
-------------------
+******************
 
 The major events for the Python community are developer conferences. The two
 most notable conferences are PyCon, which is held in the US, and its European
@@ -82,25 +87,28 @@ sibling, EuroPython.
 A comprehensive list of conferences is maintained at `pycon.org <http://www.pycon.org/>`_.
 
 
+******************
 Python User Groups
-------------------
+******************
 
 User Groups are where a bunch of Python developers meet to present or talk
 about Python topics of interest. A list of local user groups is maintained at
 the `Python Software Foundation Wiki <http://wiki.python.org/moin/LocalUserGroups>`_.
 
 
+******************
 Online Communities
-------------------
+******************
 
 `PythonistaCafe <https://www.pythonistacafe.com>`_ is an invite-only, online community
 of Python and software development enthusiasts helping each other succeed and grow.
 Think of it as a club of mutual improvement for Pythonistas where a broad range of
 programming questions, career advice, and other topics are discussed every day.
 
 
+*****************
 Python Job Boards
------------------
+*****************
 
 `Python Jobs HQ <https://www.pythonjobshq.com>`_ is a Python job board, by Python Developers
 for Python Developers. The site aggregates Python job postings from across the web and

diff --git a/docs/intro/documentation.rst b/docs/intro/documentation.rst
@@ -6,17 +6,20 @@ Documentation
 
 .. image:: /_static/photos/33928823133_2f3d32cf32_k_d.jpg
 
+
+**********************
 Official Documentation
-----------------------
+**********************
 
 The official Python Language and Library documentation can be found here:
 
     - `Python 2.x <https://docs.python.org/2/>`_
     - `Python 3.x <https://docs.python.org/3/>`_
 
 
+*************
 Read the Docs
--------------
+*************
 
 Read the Docs is a popular community project that hosts documentation
 for open source software. It holds documentation for many Python modules,
@@ -25,8 +28,9 @@ both popular and exotic.
     `Read the Docs <https://readthedocs.org/>`_
 
 
+*****
 pydoc
------
+*****
 
 :program:`pydoc` is a utility that is installed when you install Python.
 It allows you to quickly retrieve and search for documentation from your

diff --git a/docs/intro/duction.rst b/docs/intro/duction.rst
@@ -59,8 +59,10 @@ include:
 
 .. _about-ref:
 
+
+****************
 About This Guide
-----------------
+****************
 
 Purpose
 ~~~~~~~

diff --git a/docs/intro/learning.rst b/docs/intro/learning.rst
@@ -6,8 +6,10 @@ Learning Python
 
 .. image:: /_static/photos/32800783863_11a00db52c_k_d.jpg
 
+
+********
 Beginner
---------
+********
 
 The Python Tutorial
 ~~~~~~~~~~~~~~~~~~~~
@@ -195,8 +197,9 @@ making the process of learning Python fun and engaging.
     `Code the blocks <https://codetheblocks.com/tutorials/introduction>`_
 
 
+************
 Intermediate
-------------
+************
 
 Python Tricks: The Book
 ~~~~~~~~~~~~~~~~~~~~~~~
@@ -218,8 +221,9 @@ programmers.
     `Effective Python <http://www.effectivepython.com/>`_
 
 
+********
 Advanced
---------
+********
 
 Pro Python
 ~~~~~~~~~~
@@ -261,9 +265,9 @@ and can make classes and objects behave in different and magical ways.
     `A Guide to Python's Magic Methods (repo on GitHub) <https://github.com/RafeKettler/magicmethods/blob/master/magicmethods.pdf>`_
 
 
-
+****************************
 For Engineers and Scientists
-----------------------------
+****************************
 
 A Primer on Scientific Programming with Python
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -282,8 +286,10 @@ puts the emphasis on numerical methods and how to implement them in Python.
 
     `Numerical Methods in Engineering with Python <http://www.cambridge.org/us/academic/subjects/engineering/engineering-mathematics-and-programming/numerical-methods-engineering-python-2nd-edition>`_
 
+
+********************
 Miscellaneous Topics
---------------------
+********************
 
 Problem Solving with Algorithms and Data Structures
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -339,8 +345,9 @@ PythonistaCafe is an invite-only, online community of Python and software develo
     `PythonistaCafe <https://www.pythonistacafe.com>`_
 
 
+**********
 References
-----------
+**********
 
 Python in a Nutshell
 ~~~~~~~~~~~~~~~~~~~~

diff --git a/docs/intro/news.rst b/docs/intro/news.rst
@@ -6,76 +6,96 @@ News
 
 .. image:: /_static/photos/33573767786_eececc5d27_k_d.jpg
 
+
+****************
 PyCoder’s Weekly
-~~~~~~~~~~~~~~~~
+****************
 
 PyCoder’s Weekly is a free weekly Python newsletter for Python developers
 by Python developers (Projects, Articles, News, and Jobs).
 
     `PyCoder’s Weekly <https://pycoders.com/>`_
 
+
+***********
 Real Python
-~~~~~~~~~~~
+***********
 
 At Real Python you can learn all things Python from the ground up, with weekly free and in-depth tutorials. Everything from the absolute basics of Python, to web development and web scraping, to data visualization, and beyond.
 
     `Real Python <https://realpython.com/>`_
 
+
+*************
 Planet Python
-~~~~~~~~~~~~~
+*************
 
 This is an aggregate of Python news from a growing number of developers.
 
     `Planet Python <http://planet.python.org>`_
 
+
+*********
 /r/python
-~~~~~~~~~
+*********
 
 /r/python is the Reddit Python community where users contribute and vote on
 Python-related news.
 
     `/r/python <http://reddit.com/r/python>`_
 
+
+*******************
 Talk Python Podcast
-~~~~~~~~~~~~~~~~~~~
+*******************
 
 The #1 Python-focused podcast covering the people and ideas in Python.
 
     `Talk Python To Me <https://talkpython.fm>`_
 
+
+********************
 Python Bytes Podcast
-~~~~~~~~~~~~~~~~~~~~
+********************
 
 A short-form Python podcast covering recent developer headlines.
 
     `Python Bytes <https://pythonbytes.fm>`_
 
+
+*************
 Python Weekly
-~~~~~~~~~~~~~
+*************
 
 Python Weekly is a free weekly newsletter featuring curated news, articles,
 new releases, jobs, etc. related to Python.
 
     `Python Weekly <http://www.pythonweekly.com/>`_
 
+
+***********
 Python News
-~~~~~~~~~~~~~
+***********
 
 Python News is the news section in the official Python web site
 (www.python.org). It briefly highlights the news from the Python community.
 
     `Python News <http://www.python.org/news/>`_
 
+
+********************
 Import Python Weekly
-~~~~~~~~~~~~~~~~~~~~
+********************
 
 Weekly Python Newsletter containing Python Articles, Projects, Videos, Tweets
 delivered in your inbox.  Keep Your Python Programming Skills Updated.
 
     `Import Python Weekly Newsletter <http://www.importpython.com/newsletter/>`_
 
+
+*************************
 Awesome Python Newsletter
-~~~~~~~~~~~~~~~~~~~~~~~~~
+*************************
 
 A weekly overview of the most popular Python news, articles and packages.
 

diff --git a/docs/notes/contribute.rst b/docs/notes/contribute.rst
@@ -11,15 +11,19 @@ issue on GitHub_. To submit patches, please send a pull request on GitHub_.
 Once your changes get merged back in, you'll automatically be added to the
 `Contributors List <https://github.com/kennethreitz/python-guide/contributors>`_.
 
+
+***********
 Style Guide
------------
+***********
 
 For all contributions, please follow the :ref:`guide-style-guide`.
 
 .. _todo-list-ref:
 
+
+*********
 Todo List
----------
+*********
 
 If you'd like to contribute, there's plenty to do. Here's a short todo_ list.