doc: update language and structure to add consistency

I've just added bike shedding to my vocabulary, haha.