Skip to content

[DOC]: annotation tutorial: blended artist, headers, and user demo deletes - #26445

Merged
rcomer merged 1 commit into
matplotlib:mainfrom
story645:annotate-mult
Aug 7, 2023
Merged

rcomer merged 1 commit into
matplotlib:mainfrom
story645:annotate-mult

Conversation

@story645

@story645 story645 commented Aug 3, 2023

Copy link
Copy Markdown
Member

This PR adds an example of using two artists in the blended specifications just to make it more clear that's possible. While doing that, I made each of the coordinate types a subsection to make 'em easier to find. I also changed all the subsections to ^ cause that's what we specify in the doc docs.

Also got deleted and redirected the following because they're integrated into the tutorial:

@story645 story645 added topic: annotation Documentation: tutorials files in galleries/tutorials labels Aug 3, 2023

@rcomer rcomer left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like this. The layout seems better, and the extra subheadings will make it easier to link to specific things when helping people.

It looks like CI is failing because a whatsnew entry links to the userdemo example.

Does this close #24723?

t1 = ax.text(0.05, .05, "Anchor 1", va='bottom', ha='left')
t2 = ax.text(0.90, .90, "Anchor 2", ha='right')
t3 = ax.annotate("Anchored to 1 & 2", xy=(0, 0), xycoords=(t1, t2),
va='bottom', color='tab:orange',)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is golden knowledge 🤩

@story645

story645 commented Aug 6, 2023

Copy link
Copy Markdown
Member Author

I think it will once I fix the what's new?

Co-authored-by: Ruth Comer <10599679+rcomer@users.noreply.github.com>
@story645

story645 commented Aug 7, 2023

Copy link
Copy Markdown
Member Author

and the extra subheadings will make it easier to link to specific things when helping people.

My new documentation philosophy is embrace all subheadings -> also b/c I'm finding that it makes the page so much more skimmable and I think shows up better in search.

@rcomer

rcomer commented Aug 7, 2023

Copy link
Copy Markdown
Member

Milestoned for 3.8 as any backport would need to be manual (into tutorials). I’m not convinced it’s worth it so close to the release.

@story645
story645 deleted the annotate-mult branch October 12, 2023 16:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants