Better names for some enum/struct members

let's hope this doesn't break anything
Some (fairly useless) documentation