update documentation of the platform. Todo: known-issues