Agora que descobricomo usar JAXB gerar JSON Eu posso solicitar / responder com ele no meu servidor e gostaria de descobrir como posso gerar documentação útil para seres humanos que não estão usando Java. Meu código do servidor é assim:

@POST
@Path("apath")
@Consumes(MediaType.APPLICATION_JSON)
public String postAPath(InstanceWithXmlRootElementAnnotation instanceWithXmlRootElementAnnotation) {

Tudo bem se alguém estiver usando Java. Eu acabei de dar a eles o Jar com oInstanceWithXmlRootElementAnnotation classifique-o e diga-lhes para enviá-lo (sim, há um pouco mais de trabalho, ignore esses detalhes).

Se eles estão usando algum outro idioma, eu não sei como devo dizer-lhes o formato de sua carga e o que esperar do servidor se ele retornar umInstanceWithXmlRootElementAnnotation. Como posso gerar documentação que explica o formato esperado da carga útil JSON?