DOC: add some design notes about the new layering model

This explains how streams and connection should interact.
1 file changed