document all the things (ok, just the things from #5)