basic docs for decorators + errors
a little more work on documenting ferenda.util (and deprecating lots of code in the process)