doc: simplify and fix markup

I should split this commit. :<