I am exposing my API through web service (.asmx
). Currently, the only thing available is the default WSDL help page. While this is immensely helpful, it is not sufficient if my target audience requires a little more hand-holding. For instance, let us say I want to include some examples but still need automatic generation of method signatures etc.
Is there a good semi-automated (automatic method signatures but still be able to provide examples) to achieve this? I am looking for something like this which is also maintainable. Ideally something that helps me modify the default WSDL (I really like that page) would be great. All I need is for the documentation to be automatically available along with the service when it is deployed.
Any suggestions?