doc: update language and structure to add consistency

Hey, I think picking the styles here is the best bike shedding one can do.