add notes to README and add comments to COR pattern