doc: update language and structure to add consistency

ehhh