docs, a few unit tests, README changes, some renaming