Documentation 如何为客户端记录Web服务

我正在开发一个web服务。客户端的业务系统将使用这些web服务与我们的系统集成。我想提供我们的web服务的文档。记录web服务的最佳实践是什么

IMO它应该使用WSDL的WSDL:documentation元素和XSD的xs:documentation元素靠近源代码。尽管这对开发人员来说是一个有价值的、可维护的解决方案，但在面向服务的环境中向业务公开服务功能并不是一件好事

问题是，对于Java开发人员来说，JAX-WS的Java->WSDL不支持这些元素