Update README.md

Author: TheAngryByrd

README.md

@@ -5,7 +5,18 @@ FSharp.Control.WebSockets wraps [dotnet websockets](https://docs.microsoft.com/e
 
 ### Why? 
 
-Dotnet websockets only allow for one receive and one send at a time. If multiple threads try to write to a websocket, it will throw a `System.InvalidOperationException` with the message `There is already one outstanding 'SendAsync' call for this WebSocket instance. ReceiveAsync and SendAsync can be called simultaneously, but at most one outstanding operation for each of them is allowed at the same time.`. This wraps a websocket in a FIFO that allows for multiple threads to write or read at the same time. See https://docs.microsoft.com/en-us/dotnet/api/system.net.websockets.websocket.sendasync?view=netcore-2.0#Remarks
+
+#### Thread safety
+
+Dotnet websockets only allow for one receive and one send at a time. If multiple threads try to write to a websocket, it will throw a `System.InvalidOperationException` with the message `There is already one outstanding 'SendAsync' call for this WebSocket instance. ReceiveAsync and SendAsync can be called simultaneously, but at most one outstanding operation for each of them is allowed at the same time.`. This wraps a websocket in a FIFO that allows for multiple threads to write or read at the same time. See [Websocket Remarks](https://docs.microsoft.com/en-us/dotnet/api/system.net.websockets.websocket.sendasync?view=netcore-2.0#Remarks) on Microsoft for more information.
+
+#### F# friendly and correct behavior
+
+This provides a `readMessage` type function. This is the biggest stumbling block people have when working with websockets. You have to keep reading from the message until it’s finished.  People either don’t and end up having corrupted messages with a small buffer or have a buffer that is giant and can be a memory hog for smaller messages.
+
+#### Memory usage 
+
+Uses [RecyclableMemoryStreamManager](https://www.philosophicalgeek.com/2015/02/06/announcing-microsoft-io-recycablememorystream/) and [ArrayPool](https://docs.microsoft.com/en-us/dotnet/api/system.buffers.arraypool-1?view=netstandard-2.1) to help keep memory usage and GC down.
 
 ---