It's really nice of you Sam! Well, I would also suggest the documentation to be in PDF or DOC format. I find it convenient to usually print the documentation and go through it. Also, how much would you take to finish up the entire documentation?
Docbook can output to PDF and the JBoss Rules build system is able to do this. However currently its disabled due to docbook to pdf rendering problems when images cannot be rendered onto a single page. It needs someone to go all over the documentation playing with image sizes until it is able to render without crashing.
By when do you guys plan to release the updated/ new documentation??
Document detaililng patterns of usage (for example before iniating actual condition check, app wants rule engine to retrieve elements matching the criteria", and then apply condition check on those objects) etc with examples would be useful.
In current set of documents I find on Jboss site, it is not listed in appropriate form. For example, currently my engineer is trying to do this:
Asserts set of event objects and managed objects into rules and then asks rule engine to use rules file (invokeRules) which has condition check on
events and managed objects.
To do this, he has to first retrieve managed objects which match specific criteria, and then apply "condition" and action rule on those events and matched managed objects. It is not clearly documented anywhere as how to do this, (some kind of "preprocessing" before actual "condition" is evaluated.
If any of you used CLIPS, you know what I am talking of.