An example section in the wiki with real world scenarios and the code used to proces a jpdl would be useful.
For those that don't know the source code has some great examples (jbpm.test).
Slightly off topic: Does anyone know why you would use processInstance.signal(), instead of taskInstance.signal() or instead of taskInstance.end(). They all transition to the next node. But I don't know why you would use one over another. But I know taskInstance.end() closes the task, therefore I prefer that one. An explanation of that would help ;)
Example scenarios dealing with the identity component may be useful.
It seems to integrate jbpm into a legacy application it's easier to discard the jbpm identity component. If I want to limit access to an jbpm action in a legacy application, I protect the method based on an a role in an existing rbac system. From my perspective it appears a lot easier that way. But what are some example scenarios where you really need the jbpm identity component?