readme/documentation and assorted cleanup