fixes; docs
specs pass; docs ok for now; nice!