Add explanatory comments to "broken" horizontal bar plot example (matplotlib#22030)

* Update broken_barh.py

Add explanatory comments for "broken" horizontal bar plot example

* Update broken_barh.py

Make explanatory comments vertically aligned

Co-authored-by: Ruth Nainggolan <[email protected]>

Author: ruthgn

examples/lines_bars_and_markers/broken_barh.py

@@ -7,15 +7,16 @@
 """
 import matplotlib.pyplot as plt
 
+# Horizontal bar plot with gaps
 fig, ax = plt.subplots()
 ax.broken_barh([(110, 30), (150, 10)], (10, 9), facecolors='tab:blue')
 ax.broken_barh([(10, 50), (100, 20), (130, 10)], (20, 9),
                facecolors=('tab:orange', 'tab:green', 'tab:red'))
 ax.set_ylim(5, 35)
 ax.set_xlim(0, 200)
 ax.set_xlabel('seconds since start')
-ax.set_yticks([15, 25], labels=['Bill', 'Jim'])
-ax.grid(True)
+ax.set_yticks([15, 25], labels=['Bill', 'Jim'])     # Modify y-axis tick labels
+ax.grid(True)                                       # Make grid lines visible
 ax.annotate('race interrupted', (61, 25),
             xytext=(0.8, 0.9), textcoords='axes fraction',
             arrowprops=dict(facecolor='black', shrink=0.05),