Je développe un service Web. Le système d'entreprise du client s'intégrera à notre système en utilisant ces services Web. Je veux fournir la documentation de notre service web. Quelle est la meilleure pratique pour documenter le service Web?Comment documenter le service Web pour le client
IMO il devrait être proche de la source avec l'élément wsdl: documentation de WSDL et l'élément xs: documentation de XSD. Bien que ce soit une solution valable et maintenable pour les développeurs, il n'est pas bon d'exposer les fonctionnalités du service à l'entreprise dans un environnement orienté services.
Problème est, pour les développeurs Java de toute façon, que ces éléments ne sont pas pris en charge par Java-> WSDL avec JAX-WS.