Adapted documentation according to developer comments

https://github.com/stratosphere/stratosphere/pull/489