The wonderful thing about Python docstring conventions, is that there are so many to choose from!
miniblog.
Related Posts
Unison has a really nice docstring model, with helpers to interpolate values or function syntax!
https://www.unisonweb.org/docs/documentation/
Function: addToBasket docstring: "Adds to basket". I see docs like this pretty often! Inform the user, or say nothing (which is reasonable!)
Given the choice between a docstring and a type signature, I find a docstring much more helpful on the first read (ideally I'd have both!)