Housekeeping

- clean up
- documentation added to `doc/`
- doc strings added to a lot of places
FEATURE: return much more info about categorized url

- basically, merges our categorization hash-map with the readability
  parser hash-map
Documentation updates