[doc] Clarify how the ConnectionHandler works

This makes the implicit description of how connection pooling works a
little more explicit. It converts the examples of a model hierarchy into
actual Ruby code and demonstrates how the key structure of the
database.yml relates to the `establish_connection` method.
`Active Record` not `ActiveRecord` we use the `ActiveRecord` form when we are talking about the constant what it is not case here.