update High level doc strings

Delete and inform me if you wish