FIX: Change variable name to be more friendly
DOC: tidy up documentation and add some more explanation