Skip to content

DOC: Document _CollectionWithSizes - #29561

Merged
timhoffm merged 1 commit into
matplotlib:mainfrom
timhoffm:doc-set_sizes2
Feb 5, 2025
Merged

timhoffm merged 1 commit into
matplotlib:mainfrom
timhoffm:doc-set_sizes2

Conversation

@timhoffm

@timhoffm timhoffm commented Feb 1, 2025

Copy link
Copy Markdown
Member

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

timhoffm commented Feb 1, 2025

Copy link
Copy Markdown
Member Author

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

story645 commented Feb 4, 2025

Copy link
Copy Markdown
Member

I like this approach, seems very clean and intentional.

@timhoffm
timhoffm merged commit 991ae8a into matplotlib:main Feb 5, 2025
@timhoffm
timhoffm deleted the doc-set_sizes2 branch February 5, 2025 08:23
@timhoffm timhoffm mentioned this pull request Feb 5, 2025
9 tasks done
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