solved several documentation building warnings

Note: The sphinx directive .. todo:: is not supported! I decided to add in a warning directive instead with todo in the text. If we really want to add the .. todo:: directive, we have to add some external code and change the configuration of the sphinx build.