I think we can achieve the goal without explicitly saying this confuses
people. Also reorder so that it starts with what an XR is (the goal)
then talks about how to achieve the goal (XRDs, Compositions).
Signed-off-by: Nic Cope <nicc@rk0n.org>
We're considering removing connection details from XRs in v2 so for now
focus on their existence at the MR level.
Signed-off-by: Nic Cope <nicc@rk0n.org>
In some cases I've removed large amounts of content, where we're not
going to have time to rewrite it to avoid mentioning claims - e.g. how
connection secrets work in composition.
Signed-off-by: Nic Cope <nicc@rk0n.org>