Documenting the Web Service and Velocity Libraries


The Standard Model provides two reusable code libraries: one for web services, and the other for Velocity. To make both libraries more usable, source code is annotated in some specific way to facilitate automatic generation of documentation pages. These documentation pages provide descriptions of classes and macros, explanation on how to use the libraries with plenty of examples, and can be generated on any Cascade instance. The two libraries provide code to read the annotations and generate the documentation page contents using either web services or macro invocations.


Wing Ming Chan

Wing Ming Chan

Web Programmer
SUNY Upstate Medical University
http://www.upstate.edu/

Wing has a PhD degree in linguistics and an MS degree in computer science, besides an MA degree in Chinese. He loves programming, and spends a lot of time doing that as a hobby. He also loves classical music, operas, and ballets. He is happily married and has two dogs.