REVIEW-4369: spec updates (mostly open issues)