More doc cleanup
Added status check & uaid parm for sharding

* fixed som comments
* allow socket hello to re-establish link rather than block.