doc and code changes for correlation