Improved association documentation.
Code highlighting.
Simplified migration examples.

While I prefer the former code for clearly seeing each related piece,
@bendrucker requested this to be simplified.
Improved examples.

This should make things a little more clear without complicating the
examples with extra promise details.
Merge pull request #364 from wbyoung/doc

Documentation Changes