Skip to content

DOC: document optional arguments on plot submethods #11042

Open
@shoyer

Description

@shoyer

As a follow up on #9321:

We should start adding optional arguments that are common between multiple plot types to the signatures for plotting sub-methods, such as figsize and axis. Currently, these are only documented on the main .plot() methods and we use **kwargs for the rest. This would be nice because we could clarify for users which optional arguments work for which types of plots -- this is not at all obvious right now.

@JanSchulz suggests we could perhaps do this dynamically by updating the __signature__ object. However, I don't know yet if this will generate the correct API documentation -- maybe if Sphinx is run using Python 3?

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions