Improve std os documentation #2

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

This also seems to have duplicated the documentation from above.