> Your thinking is correct and precise, but I hope you never take a job of documentation writer for any project I will ever have to work with :) I agree, that

> Your thinking is correct and precise, but I hope you never take a job of documentation writer for any project I will ever have to work with :) I agree, that was terrible. > My example of documenting re.findall all would be smth like this The hard part is to have everybody agree on the documentation mini-languge. https://www.python.org/dev/peps/pep-3107/ https://www.python.org/dev/peps/pep-3107/ https://www.python.org/dev/peps/pep-0484/ https://www.python.org/dev/peps/pep-0484/