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 
this reads funny

how about

In the following example, we will use Application regions as the base of our view tree.

or something