Updates docs to use getter methods.

Continuing from #1892
Good idea. I chose not to elaborate because I want people to just not do it and forget that it's even an option. But I think explaining it is safer. I'll open a new PR.