Add example for plotting a bihistogram

[i-jey]

PR summary

Adds an example to the documentation for plotting a bihistogram (see the closed PR #27180 for prior discussion)

PR checklist

• [NA] "closes #0000" is in the body of the PR description to link the related issue
• new and changed code is tested
• Plotting related features are demonstrated in an example
• [NA] New Features and API Changes are noted with a directive and release note
• Documentation complies with general and docstring guidelines

[scottshambaugh]

I think this example is well done and useful! Only suggestion is that I think it would make more sense visually when comparing datasets like this to have a constant bin width rather than constant number of bins, and share them between the datasets. For example:

bin_width = 0.25
bins = np.arange(np.min([dataset1, dataset2]), np.max([dataset1, dataset2]) + bin_width, bin_width)
ax.hist(dataset1, bins=bins, label="Dataset 1")

[i-jey]

That's a good catch, totally agree. I've added that in, thanks for taking a look!

[scottshambaugh]

The built docs look good to me.

[scottshambaugh]

@i-jey thanks and congratulations on your first contribution to Matplotlib! 🎉

We hope to see you again!