updating docs to reflect SS 3.1 changes