Document SuperAccessors

Added comment giving an up-to-date overview of SuperAccessors
and how we might want to change it.
Merge pull request #3863 from adriaanm/rebase-3852

Document SuperAccessors