FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

[Doc]: update lifecycle tutorial to use annotate and bar labels · Issue #27610 · matplotlib/matplotlib · GitHub

Repository navigation

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

Open

Description

Documentation Link

https://matplotlib.org/devdocs/tutorials/lifecycle.html#sphx-glr-tutorials-lifecycle-py

Problem

This is a nice tutorial on making an infographic that could probably be modernized a bit to show off functionality.

Suggested improvement

  • use annotate and bar_label
  • replace pyplot vs OO section w/ link to where that's discussed in user guide
  • put final image at top to make clear where the tutorial is going/as selling point

Activity

  1. harsha-mangena commented on Jan 9, 2024

    @story645, Can I work on this?

  2. story645 commented on Jan 9, 2024

    MemberAuthor

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

  3. timhoffm commented on Mar 29, 2026

    Member

    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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions


      Back | FazBrowse Home | New Git URL