Complete some package upkeep

Docs needed updating.

Added some comments to the code.

Updated package.json.