[COOK-2856] - incorporates feedback from review

* Clarify deprecated / replaced attributes.
* Add a comment about local variables for method use, and make the
  variables > 1 character long