You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Hi, I’m a new contributor interested in helping improve the documentation for SecondaryAxes.
Since this issue has been open for a while, I wanted to check if it’s still relevant and if it would be okay for me to work on it. I’m happy to review the current docs and propose improvements or examples.
@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.
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:
***@***.***>
Activity
sahil-11116 commentedon Mar 5, 2026
Hi, I’m a new contributor interested in helping improve the documentation for SecondaryAxes.
Since this issue has been open for a while, I wanted to check if it’s still relevant and if it would be okay for me to work on it. I’m happy to review the current docs and propose improvements or examples.
Thanks!
timhoffm commentedon Mar 6, 2026
@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.
sahil-11116 commentedon Mar 6, 2026
timhoffm commentedon Jun 2, 2026
Still todo: compare/contrast this with twin axes.