Summary

The manual docs for linestyle in #27996 have me thinking of the ideas in #18664 and that we can do a simplified version of this using :mpltypes and _docstring.interp that we can then use to have a consistent way to document linestyle across the library.

Proposed fix

1. Make something the following table linestyle_doc for _docstyle.interpd:

              ==========================================  =================
              linestyle                                   description
              ==========================================  =================
              ``'-'``  ``'solid'``                      solid line
              ``'--'`` or  ``'dashed'``                   dashed line
              ``'-.'`` or  ``'dashdot'``                  dash-dotted line
              ``':'`` or ``'dotted'``                     dotted line
              ``'none'``, ``'None'``, ``' '``, or ``''``  draw nothing
              ==========================================  =================

1. Add something like that table to linestyles reference (apparently can't reuse the interp in examples :/)
2. Add linestyles and a link to the linestyles reference to

   matplotlib/lib/matplotlib/sphinxext/roles.py

   Lines 126 to 128 in 436a12a

   	type_to_link_target = {
   	'color': 'colors_def',
   	}