documentation updates and lighterweight serialization