Thank you for the clarification! I understand that documenting SecondaryAxes properly requires a good understanding of how it works and how it differs from other axis concepts. I’m still relatively new to contributing to Matplotlib, so I’ll first spend some time reading the existing documentation and examples to understand the feature better. If it turns out that this issue is too complex for me right now, I will start with some smaller documentation improvements and come back to this topic later. Thanks again for the guidance!

…

On Fri, 6 Mar, 2026, 7:43 pm Tim Hoffmann, ***@***.***> wrote: *timhoffm* left a comment (matplotlib/matplotlib#29004) <#29004 (comment)> @sahil-11116 <https://github.com/sahil-11116> you are welcome to dig into the topic. However, I want to warn you that this is non-trival. SecondaryAxes is a subtle and to a certain extent not architecturally good concept. You need to understand what it is intended for, how it works, how it differs from other concepts and present that in a consistent user-facing way. Do you have experience in writing good user-facing documentation for technical topics? Otherwise I'm afraid that the result is not what we are aiming for and we'd have to rather dictate what to write, which would be much more work than writing it myself. — Reply to this email directly, view it on GitHub <#29004 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BXXUIA3LU35VYDVIDEM2RT34PLMJHAVCNFSM6AAAAACWIVXH62VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHM2DAMJRHE4DOMRXHA> . You are receiving this because you were mentioned.Message ID: ***@***.***>

Uh oh!

Decide how to document SecondaryAxes #29004

Description

Documentation Link

Problem

Suggested improvement

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions