2011/3/28 Bryan Tong Minh bryan.tongminh@gmail.com:
That would be the best way to go. You really don't want to do this manually. Every API modules has a function getFinalParamDescription() which will give you the parameter description, including the defaults and the variable type. Best look at ApiBase::makeHelpMsgParameters() how this is handled by the documentation generator.
I said this on IRC but I'll repeat it here: the API exposes the data from getFinalParamDescription() and friends through action=paraminfo.
Roan Kattouw (Catrope)