- added some missing type-hints - added some documentation - added some empty lines to `@return` statements (code-style convention)