Improve std os documentation #2

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

This doesn't belong in a "Failure" section because no failure is happening.