more docs

README.md

@@ -33,11 +33,13 @@ format. The format from 0.3.0 onwards is supposed to keep compatible.
 - JS (browser and nodeJS)
 - JVM (android, macos, windows, linx, everywhere where JRE is installed)
 
-## TCP/IP transport
+## TCP/IP and UDP transports
 
-It is the fastest based on async socket implementation of ktor client. It works everywhere but JS target as
+These are the fastest based on async socket implementation of ktor client. They works everywhere but JS target as
 there is currently no widely adopted sockets for browser javascript.
 
+While UDP is faster than TCP/IP, it is less reliable, especially with commands and return values that serializes to more than 240 bytes approx, and has no retransmission facilities (use TCP!). UDP though shines when all you need is to [push](https://code.sergeych.net/docs/kiloparsec/kiloparsec/net.sergeych.kiloparsec/-remote-interface/push.html) with little or no data in it.
+
 ## Websock server
 
 While it is much slower than pure TCP, it is still faster than any http-based transport. It uses binary frames based on