more work on docs and fixed a naming convention bug in IdentityOptimizer.