In other threads I mentioned several times the problems with the documentation on jBPM and Seam. however I feel also that this is a problem with the
basicJbpm (3) project which is integrated with Seam. The docs of JBPM 3 are more a scientific paper than a user manual and there are a lot of things missing. Most of my gray hairs are from figuring out how to get the sub-processes activated and integrated with Seam (use the binding attribute and set it to LATE !!!), the timed jobs activated and working, the email support improved (search for Craig Bensemann's thread with an improved class), the transaction problems etc. etc.
I am using the Seam-annotations for jBPM only for the most basic workflows. Whne it is a bit more comples I use the jBPM API's directly.
The 4 and 5 and docs are really and improvement, and I really would like to have some time to test them with Seam. On the other hand, this will probably be available with Seam 3 (?).
I am using seam annotations to the basic too.
For advanced purposes, I am using API directly. I looked several times into the source code to learn how to use some components.