Updates docs to use getter methods.

Our docs didn't explicitly suggest using the getter methods, and at times even used direct references in the examples.

We've deprecated direct access, so I made the docs more explicit about that.