> Docs should be about how things **are**

Exactly :)