improved documentation to be less ambiguous

and added a reference link to the JMS Serializer documentation