diff --git a/examples/lines_bars_and_markers/joinstyle.py b/examples/lines_bars_and_markers/joinstyle.py
index f052b37cfcd5..dcc47105d12f 100644
--- a/examples/lines_bars_and_markers/joinstyle.py
+++ b/examples/lines_bars_and_markers/joinstyle.py
@@ -9,17 +9,15 @@
 `matplotlib.collections` as well as some functions that create these, e.g.
 `~matplotlib.pyplot.plot`.
 
-"""
 
-#############################################################################
-#
-# Join styles
-# """""""""""
-#
-# Join styles define how the connection between two line segments is drawn.
-#
-# See the respective ``solid_joinstyle``, ``dash_joinstyle`` or ``joinstyle``
-# parameters.
+Join styles
+===========
+
+Join styles define how the connection between two line segments is drawn.
+
+See the respective ``solid_joinstyle``, ``dash_joinstyle`` or ``joinstyle``
+parameters.
+"""
 
 import numpy as np
 import matplotlib.pyplot as plt
@@ -54,7 +52,7 @@ def plot_angle(ax, x, y, angle, style):
 #############################################################################
 #
 # Cap styles
-# """"""""""
+# ==========
 #
 # Cap styles define how the the end of a line is drawn.
 #