Doc fixes

Please let me know if I misunderstood certain information.
Maybe it’s nicer to just change this in the code so that it's immediately clear when reading the code.