Improve std os documentation #2

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

The `&ref` in this pattern shouldn't be necessary