Updated example to be in line with best practices

Changing the example documentation to be in line with best practices. This seems to be a popular complaint:

http://docs.angularjs.org/guide/dev_guide.mvc.understanding_controller#comment-831705214

I'll update the rest of the docs if this gets approved.