Documentation improvement: JAXB/Jackson vs JAXB/JSON

[behrangsa]

Hi,

In the docs, there's a section (emphasis mine):

JAXB / JSON integration

As representations for REST web services are usually rendered in either XML or JSON the natural choice of technology to achieve this is either JAXB, JSON or both in combination. To follow HATEOAS principles you need to incorporate links into those representation. Spring HATEOAS provides a set of useful types to ease working with those.

However, JAXB is an API while JSON is a data interchange format. I think this section should be changed to something like this:

JAXB/Jackson integration

As representations for REST web services are usually rendered in either XML or JSON the natural choice of technology to achieve this is either JAXB, Jackson or both in combination. To follow HATEOAS principles you need to incorporate links into those representation. Spring HATEOAS provides a set of useful types to ease working with those.