updated documentation for new architecture, plus did file cleanup, reinstated tests, and a few other small updates.  Too much for one commit, really.