Skip to content

DOC: Document _CollectionWithSizes #29561

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Feb 5, 2025
Merged

Conversation

timhoffm
Copy link
Member

@timhoffm timhoffm commented Feb 1, 2025

This is needed to get _CollectionWithSizes.set_sizes documented so that it can be referenced.

Alternative approach to #29560.

@github-actions github-actions bot added the Documentation: API files in lib/ and doc/api label Feb 1, 2025
@timhoffm timhoffm force-pushed the doc-set_sizes2 branch 3 times, most recently from d268cc8 to 6349fa0 Compare February 1, 2025 18:35
@timhoffm timhoffm marked this pull request as draft February 1, 2025 19:52
This is needed to get `_CollectionWithSizes.set_sizes` documented so
that it can be referenced.

Alternative approach to matplotlib#29560.
@timhoffm
Copy link
Member Author

timhoffm commented Feb 1, 2025

Sphinx configuration was a bit tricky. I had to override some defaults from autodoc_default_options to make the documentation on these private classes minimal (I.e. reduced to the minimal need-to-know).

Anyway, I believe it's reasonable to have minimal documentation on the private base classes. The aspects that leak out in the child classes should be documented. We cannot completely hide a private base class.

@story645
Copy link
Member

story645 commented Feb 4, 2025

I like this approach, seems very clean and intentional.

@timhoffm timhoffm merged commit 991ae8a into matplotlib:main Feb 5, 2025
27 checks passed
@timhoffm timhoffm deleted the doc-set_sizes2 branch February 5, 2025 08:23
timhoffm added a commit to timhoffm/matplotlib that referenced this pull request Feb 5, 2025
timhoffm added a commit to timhoffm/matplotlib that referenced this pull request Feb 5, 2025
@QuLogic QuLogic added this to the v3.11.0 milestone Feb 7, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation: API files in lib/ and doc/api
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants