Document design decisions

[jacobtomlinson]

This library manages pods directly via the Kubernetes API. This is a design decision we made for many reasons.

People often ask why we didn't use a different resource type, or built in scaling techniques, or built in monitoring techniques, or other things. I think it would be helpful to document why decisions were made to help point people to in future.