Add docs section on design choices

[mstechly]

As we discussed, it would be good to have a section of the docs discussing the design choices we made, in particular why do we have Schema and Routine objects separate.