fix for GCOD-329
add instructions to README for resolving GCOD-147
fix for GCOD-190