documentation changes

Hey Hannes, can we incorporate these changes?