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?
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
figsizeandaxis. Currently, these are only documented on the main.plot()methods and we use**kwargsfor 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?