Carefully document semantics.

[qnikst]

We need to carefully document network-transport semanitics covering all events that should/must and may happen when some action have happened.

[facundominguez]

Possibly include some design documentation and discuss
#204
#199