we said we follow the symfony doc standard, so lets do it like there. i did that wrong in all doc i did, i think. lets discuss the general issue in #111 but keep with the doc standards for all open doc PRs.