Improve documentation of connections
Improve documentation of connections

Some errors in the original ideas, updated
to form the basis of the unit tests and code
to follow.

Change-Id: If13f8dfaa96c622bf2efe5bb4fe9f9d7ac6780f4

Linaro/lava-server,Linaro/lava-server,Linaro/lava-server,Linaro/lava-server