[Doc]: update lifecycle tutorial to use annotate and bar labels #27610

Activity

1. story645

   added

   Documentation: tutorialsfiles in galleries/tutorialsfiles in galleries/tutorials

   on Jan 8, 2024
2. harsha-mangena commented on Jan 9, 2024

   

   harsha-mangena

   on Jan 9, 2024

   More actions

   @story645, Can I work on this?
3. story645 commented on Jan 9, 2024

   

   story645

   on Jan 9, 2024

   MemberAuthor

   More actions

   Go for it, we don't really assign issues.
4. dstansby

   added

   Documentation

   on Aug 13, 2025
5. timhoffm commented on Mar 29, 2026

   

   timhoffm

   on Mar 29, 2026

   Last edited by timhoffm

   Member

   More actions

   Fundamental content issues:

   • pyplot vs. OO is out-of-scope. IMHO its mention here is historic and should be removed completely. The OO interface is our baseline and we should just use this here without any discussion.
   • The discussion of the terms figure/axes is also out of scope. The whole paragraph https://matplotlib.org/devdocs/tutorials/lifecycle.html#a-note-on-the-explicit-vs-implicit-interfaces should just be deleted.
   • I think the title is also misleading. Under "lifecycle" I would understand: create figue+Axes, add data, add "context" (title, labels, legend), customize, show/save. But with a focus on these categories. While the present code has these, it puts much stronger emphasis on demonstrating in-depth how a figure can be fine-tuned to a desired output. I think this should be rephrased to "Fine-tuning visualization" or similar.
     Likely part of this stems from the fact that the original blog post has a different intention and scope that our example, but content was not appropriately adapted/rephrased.

   I've addressed the first two bullet points in #31423, because this is independent of the other topics here, and should hopefully be general consensus so that we can get it out of the way quickly.

   @story645 please specify in more detail how you want to "use annotate and bar_label". I'm not clear where they should be employwed, and I believe that's also the core issue in #31364.