updated internal comments for serializers