Add some notes on things to think about when we work out these facade
interfaces a bit more.