removed out-of-date docs, preparing to write new ones