CODE REVIEW javadocs for 'workflow' package