realpython · mpoulin · Nov 30, 2018 · Nov 29, 2018
diff --git a/docs/404.rst b/docs/404.rst
@@ -1,5 +1,7 @@
+
+#################
 404 — Not Found
-===============
+#################
 
 **Sorry, but we couldn't find the page you requested.**
 

diff --git a/docs/index.rst b/docs/index.rst
@@ -6,8 +6,10 @@
 .. meta::
    :description: An opinionated guide to the Python programming language and a best practice handbook to the installation, configuration, and usage of Python on a daily basis.
 
+
+#################################
 The Hitchhiker's Guide to Python!
-=================================
+#################################
 
 Greetings, Earthling! Welcome to The Hitchhiker's Guide to Python.
 

diff --git a/docs/intro/community.rst b/docs/intro/community.rst
@@ -1,7 +1,9 @@
 .. _the-community:
 
+
+#############
 The Community
-=============
+#############
 
 .. image:: /_static/photos/34689432801_78d97ecec9_k_d.jpg
 

diff --git a/docs/intro/documentation.rst b/docs/intro/documentation.rst
@@ -1,5 +1,8 @@
+
+
+#############
 Documentation
-=============
+#############
 
 .. image:: /_static/photos/33928823133_2f3d32cf32_k_d.jpg
 

diff --git a/docs/intro/duction.rst b/docs/intro/duction.rst
@@ -1,5 +1,8 @@
+
+
+############
 Introduction
-============
+############
 
 .. image:: /_static/photos/34725946825_0f85497e60_k_d.jpg
 

diff --git a/docs/intro/learning.rst b/docs/intro/learning.rst
@@ -1,5 +1,8 @@
+
+
+###############
 Learning Python
-===============
+###############
 
 .. image:: /_static/photos/32800783863_11a00db52c_k_d.jpg
 

diff --git a/docs/intro/news.rst b/docs/intro/news.rst
@@ -1,5 +1,8 @@
+
+
+####
 News
-====
+####
 
 .. image:: /_static/photos/33573767786_eececc5d27_k_d.jpg
 

diff --git a/docs/notes/contribute.rst b/docs/notes/contribute.rst
@@ -1,5 +1,6 @@
+##########
 Contribute
-~~~~~~~~~~
+##########
 
 .. image:: /_static/photos/33573769116_49c1ef51e7_k_d.jpg
 

diff --git a/docs/notes/license.rst b/docs/notes/license.rst
@@ -1,6 +1,6 @@
-=======
+#######
 License
-=======
+#######
 
 .. image:: /_static/photos/32800805573_568d6b72fd_k_d.jpg
 

diff --git a/docs/notes/styleguide.rst b/docs/notes/styleguide.rst
@@ -1,8 +1,8 @@
 .. _guide-style-guide:
 
-=====================
+#####################
 The Guide Style Guide
-=====================
+#####################
 
 .. image:: /_static/photos/33573755856_7f43d43adf_k_d.jpg
 

diff --git a/docs/scenarios/admin.rst b/docs/scenarios/admin.rst
@@ -1,5 +1,7 @@
+
+######################
 Systems Administration
-======================
+######################
 
 .. image:: /_static/photos/34435690580_3afec7d4cd_k_d.jpg
 

diff --git a/docs/scenarios/ci.rst b/docs/scenarios/ci.rst
@@ -1,5 +1,7 @@
+
+######################
 Continuous Integration
-======================
+######################
 
 .. image:: /_static/photos/33907150594_9abba7ad0a_k_d.jpg
 

diff --git a/docs/scenarios/cli.rst b/docs/scenarios/cli.rst
@@ -1,5 +1,7 @@
+
+#########################
 Command-line Applications
-=========================
+#########################
 
 .. image:: /_static/photos/34435690330_11930b5987_k_d.jpg
 

diff --git a/docs/scenarios/clibs.rst b/docs/scenarios/clibs.rst
@@ -1,5 +1,7 @@
+
+################################
 Interfacing with C/C++ Libraries
-================================
+################################
 
 .. image:: /_static/photos/34725951345_c8f5959a2e_k_d.jpg
 

diff --git a/docs/scenarios/client.rst b/docs/scenarios/client.rst
@@ -1,5 +1,7 @@
+
+####################
 Network Applications
-====================
+####################
 
 .. image:: /_static/photos/34364815780_bea6614025_k_d.jpg
 

diff --git a/docs/scenarios/crypto.rst b/docs/scenarios/crypto.rst
@@ -1,5 +1,7 @@
+
+############
 Cryptography
-============
+############
 
 .. image:: /_static/photos/33907152824_bf91078cc1_k_d.jpg
 

diff --git a/docs/scenarios/db.rst b/docs/scenarios/db.rst
@@ -1,5 +1,7 @@
+
+#########
 Databases
-=========
+#########
 
 .. image:: /_static/photos/33907152464_a99fdcc8de_k_d.jpg
 

diff --git a/docs/scenarios/gui.rst b/docs/scenarios/gui.rst
@@ -1,5 +1,7 @@
+
+################
 GUI Applications
-================
+################
 
 .. image:: /_static/photos/33907143624_cd621b535c_k_d.jpg
 

diff --git a/docs/scenarios/imaging.rst b/docs/scenarios/imaging.rst
@@ -1,6 +1,7 @@
-==================
+
+##################
 Image Manipulation
-==================
+##################
 
 .. image:: /_static/photos/34575689432_3de8e9a348_k_d.jpg
 

diff --git a/docs/scenarios/json.rst b/docs/scenarios/json.rst
@@ -1,5 +1,7 @@
+
+####
 JSON
-====
+####
 
 .. image:: /_static/photos/33928819683_97b5c6a184_k_d.jpg
 

diff --git a/docs/scenarios/ml.rst b/docs/scenarios/ml.rst
@@ -1,6 +1,8 @@
-================
+
+
+################
 Machine Learning
-================
+################
 
 .. image:: /_static/photos/34018729885_002ced9b54_k_d.jpg
 

diff --git a/docs/scenarios/network.rst b/docs/scenarios/network.rst
@@ -1,5 +1,7 @@
+
+##########
 Networking
-==========
+##########
 
 .. image:: /_static/photos/34151833832_6bdfd930af_k_d.jpg
 

diff --git a/docs/scenarios/scientific.rst b/docs/scenarios/scientific.rst
@@ -1,6 +1,7 @@
-=======================
+
+#######################
 Scientific Applications
-=======================
+#######################
 
 .. image:: /_static/photos/33925223870_97e44f5629_k_d.jpg
 

diff --git a/docs/scenarios/scrape.rst b/docs/scenarios/scrape.rst
@@ -1,5 +1,7 @@
+
+#############
 HTML Scraping
-=============
+#############
 
 .. image:: /_static/photos/34268661876_442428e122_k_d.jpg
 

diff --git a/docs/scenarios/serialization.rst b/docs/scenarios/serialization.rst
@@ -1,6 +1,7 @@
-==================
+
+##################
 Data Serialization
-==================
+##################
 
 .. image:: /_static/photos/33467946364_3e59bd376a_k_d.jpg
 

diff --git a/docs/scenarios/speed.rst b/docs/scenarios/speed.rst
@@ -1,5 +1,7 @@
+
+#####
 Speed
-=====
+#####
 
 .. image:: /_static/photos/33175625804_e225b90f3e_k_d.jpg
 

diff --git a/docs/scenarios/web.rst b/docs/scenarios/web.rst
@@ -1,6 +1,7 @@
-=============================
+
+#############################
 Web Applications & Frameworks
-=============================
+#############################
 
 .. image:: /_static/photos/34309496175_b82d104282_k_d.jpg
 

diff --git a/docs/scenarios/xml.rst b/docs/scenarios/xml.rst
@@ -1,5 +1,7 @@
+
+###########
 XML parsing
-===========
+###########
 
 .. image:: /_static/photos/33888714601_a1f7d020a2_k_d.jpg
 

diff --git a/docs/shipping/freezing.rst b/docs/shipping/freezing.rst
@@ -1,8 +1,9 @@
 .. _freezing-your-code-ref:
 
-==================
+
+##################
 Freezing Your Code
-==================
+##################
 
 .. image:: /_static/photos/33907151034_e0a9e53402_k_d.jpg
 

diff --git a/docs/shipping/packaging.rst b/docs/shipping/packaging.rst
@@ -1,8 +1,9 @@
 .. _packaging-your-code-ref:
 
-===================
+
+###################
 Packaging Your Code
-===================
+###################
 
 .. image:: /_static/photos/36137234682_be6898bf57_k_d.jpg
 

diff --git a/docs/starting/install/linux.rst b/docs/starting/install/linux.rst
@@ -1,7 +1,9 @@
 .. _install-linux:
 
+
+############################
 Installing Python 2 on Linux
-=============================
+############################
 
 .. image:: /_static/photos/34435688560_4cc2a7bcbb_k_d.jpg
 

diff --git a/docs/starting/install/osx.rst b/docs/starting/install/osx.rst
@@ -1,7 +1,9 @@
 .. _install-osx:
 
+
+###############################
 Installing Python 2 on Mac OS X
-===============================
+###############################
 
 .. image:: /_static/photos/34435688560_4cc2a7bcbb_k_d.jpg
 

diff --git a/docs/starting/install/win.rst b/docs/starting/install/win.rst
@@ -1,7 +1,9 @@
 .. _install-windows:
 
+
+##############################
 Installing Python 2 on Windows
-==============================
+##############################
 
 .. image:: /_static/photos/34435688560_4cc2a7bcbb_k_d.jpg
 

diff --git a/docs/starting/installation.rst b/docs/starting/installation.rst
@@ -1,7 +1,9 @@
 .. _installation:
 
+
+##########################
 Properly Installing Python
-==========================
+##########################
 
 .. image:: /_static/photos/36137232412_fdcb0f84eb_k_d.jpg
 

diff --git a/docs/starting/which-python.rst b/docs/starting/which-python.rst
@@ -1,5 +1,8 @@
+
+
+#####################################
 Picking a Python Interpreter (3 vs 2)
-=====================================
+#####################################
 
 .. image:: /_static/photos/34484834733_5b80f65ab1_k_d.jpg
-Original file line number
+Diff line change
@@ -1,5 +1,8 @@
+    ####
     News
-    ====
+    ####
     .. image:: /_static/photos/33573767786_eececc5d27_k_d.jpg
@@ Expand Down @@