can we have some JavaDoc for new classes ? serialization is already a big unknown for most developers and it would be good to add information both for new-comers and us.