Improve std os documentation #2

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

As above, this section is a little misleading because no failure is occurring.