Genial la explicación de esto que es vital para el entendiemiento de un código, es por ello que para quienes usan “visual studio code” les recomiendo la siguiente extensión que ayuda mucho al momento de realizar la documentación.
EXTENCION = autoDocstring - Python Docstring Generator