better protocol documentation

[dominictarr]

trying to add a feature, I found my self forgetting lots of stuff about how the protocol works.
such as: when peers connect, one is the client (who calls), the server is expected to send vector clock (notes) first. the place where this happens looks like this:

  //client should wait for the server notes, so that stream
  //can error before a peer sends a massive handshake.
  if(peer.replicating == null) return state

kinda difficult to understand, not very obvious that peer.replicating being unset means means...
in connect:

    //if we are client, wait until we receive notes to send code.
    //this is a weird way of doing it! shouldn't we just have a bit of state
    //for wether we have received a vector clock
    replicating: ev.client ? null : {}

now I recall, this was a JGIW (just get it working)...

[dominictarr]

comment to experiment with github issue flow...