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.

I also updated the wording or examples in a few places.

Resolves #1890 
:+1: