osch some documentation, improvements and minor fixes