I like the idea of the parameters next to the images since it makes it very clear these aren't defaults what's controlled by parameters.

I like the idea of the parameters next to the images since it makes it very clear these aren't defaults [...].

🤣 SCNR, but this is part of my point.

I see the desire to provide the parameters, but as of now they are really cluttering the images. 1) It's hard to see what the main
distincting parameters are 2) It's not clear what these additional parameters mean.

We don't have rich-text do we? Otherwise we could use color/font weight/font size to highlight the main parameter compared to the other parameters.

I think, we'd rather want something like

import inspect

import matplotlib.pyplot as plt
import matplotlib.transforms as mtransforms
import matplotlib.patches as mpatch
from matplotlib.patches import FancyBboxPatch

styles = mpatch.BoxStyle.get_styles()
ax = plt.figure(figsize=(5, len(styles))).add_axes([0, 0, 1, 1])
ax.set_axis_off()
ax.set(xlim=(0, 1), ylim=(len(styles) + 0.5, -0.5))

ax.text(.15, 0, 'boxstyle', fontsize=18, ha="center", va="center")
ax.text(.45, 0, 'default parameters', fontsize=18, va="center")

for i, (stylename, stylecls) in enumerate(styles.items(), start=1):
    ax.text(.15, i, stylename, fontsize=15, color='tab:blue',
            ha="center", va="center",
            bbox=dict(boxstyle=stylename, fc="w", ec="k"))
    ax.text(.45, i, str(inspect.signature(stylecls))[1:-1].replace(', ', '\n'),
            va='center')

Similarly for the arrow style (e.g. move the parameters to the right, highlight the style name in blue, make the target marker grey).

How do the ones below look to you?

I think specifically for arrows it's better to keep the arrowstyle on the left (because that's what "<-" means...), and then it seems natural to keep the parameters next to the arrowstyle...

These look good. Some minor improvements:

• The style labels could be a bit larger
• left-align the boxstyle parameters
• Agreed that the arrows should stay as is, e.g.
  
  Nevertheless the parameters could be on their right (parameters are less important than the style names, and english reading direction is left-to-right).
  If you really want to keep the parameters on the left, still consider to left-align the text. I haven't tried but anticipate that this would look cleaner.

In #20546, I'm dropping the 50% scale of the figures in the tutorials, because they are generally too small to be useful. I'm not sure exactly how big the figure ends up here now, but in order to avoid scaling, it would be good if you can make the figure fit the text width of the new theme. That would be about 749.167 pixels, or just under 7.5 inches at 100 DPI (though I wonder if we could tweak the theme to be a rounder number.)

Sure. Perhaps you can document that size somewhere?

Previously, the content width was 919px. Reducing that in the new theme is a broader issue that will cause many figures to be rescaled and thus look blurry. We have

• figsize=(8: 43
• figsize=(9: 16
• figsize=(1x: 22

It's worth discussing if we want to increase the width of the theme. Going to 800px would at least save the 43 figures with 8inch width.

Once decided, the width should be documented in Writing examples and tutorials.

[Agreed that I should just pick a size and go with it for now.]