REVIEW-3410 minor update on the userguide. Update release notes.