The code has changed quickly in the past months, and the docs need a refresh. I'd especially like to see us have better docs for new devs/users who aren't us, and don't have all the Webmaker context/background that we assume.
See #451 for some initial thoughts.