1.0.0: Merge branch 'task/readme' into 'master'

Added some clarifications and type hints to the readme



See merge request !2