Some time ago I needed to produce some documentation describing existing soap webservices. I looked into other tools that already do this, but none of them produced the output in a format that suited me, also the schema for the webservice has literally hundreds of options that were rarely or never used, or were never or no longer supported. I thought that using the existing tools would make the reader even more confused.
I recently had to put in place a public facing soap web service with Spring and WS-Security. While the tutorials on Spring Source are great, if you requirements deviate from the sample tutorials it is difficult to track down any extra information needed.