CODE REVIEW javadocs in 'maps','reports','states','workflow'