I had thought about this too. I choose the current way because the document now goes from 'not that magic' to very magic to using magic methods. I like to have some easy starting point where people can understand what is going on.

But I'm in for changing this if other people feel the same as you, @weaverryan what do you think?