Add more documentation to gracedb_events.py; update documentation elsewhere; fixes #25

This MR both addresses #25 (closed) by defining the relevant parameters, as well as updating the documentation in conjunction with !93 (merged)