Updated docs with comments by Philipp.