cosmetic changes to the documentation

(more to come)
I guess that whole note could be taken out ... This information belong to the release note. We're here to document the current state, not its evolution.