Design for #737

Explains where we need to get namespace information passed through and where the deployment object needs to be adjusted to account for this.
We decided this should be mandatory, I think. And maybe it should just be `namespace`, in case we grow non-namespaced versions of the other objects?