improves documentation for serialization
fixes reflection warnings