JDF-286 improved comments in code