cleanup/clarify docs a bit