derialization refactoring, added missing class and docs
updates to doc generation
added README