Cliente Webservice Java (melhor forma)

eu tenho um terceiro WSDL, eu preciso escrever código em Java para um cliente de serviço web para invocar as operações ... a tenho estas opções C:\axis2-1.5.1\bin>wsdl2java -uri mywsdlurl -o client -p somepackage -d xmlbeans -s -t -ssi

Como documentar uma API de serviço web?

Tenho um problema em documentar a minha API do serviço web. Ele é escrito em Java, então eu uso java2wsdl go gerar arqui ... ra isto? Preciso de documentação que possa dar ao utilizador. Documento o meu código Java inicial? Como deve ser feito?