Well, that's throwing people implementing subclasses under the bus, IMO.
Why not just add @param annotations in your docstrings instead?
Why not just add @param annotations in your docstrings instead?
If they need to touch this argument in an overridden method and they don't know what they are doing, then yes.
> Why not just add @param annotations in your docstrings instead?
I'm using Sphinx and it renders them separately. I want the empty dict to show up in the function signature.
There are other ways to emphasize it ought to be a dict/mappable. Change its name to be suffixed as "_dict", for example?