Document SuperAccessors

[Rebase of #3852 on 2.11.x]

Added comment giving an up-to-date overview of SuperAccessors
and how we might want to change it.