Also makes minor improvement on the python implementation documentation.
Co-authored-by: Pieter Wuille <pieter@wuille.net>