improve javadoc and messages in process api