Improve std os documentation #2

Improving documentation, consistency, removes evils empty lines etc...

Either way is fine.