Osm doc update

this adresses #528 and #443