Improve documentation on duplex.rs

Adding example and short documentation for methods.
I added an example and will try to adapt documentation from both Sender and Receiver for DuplexStream.
I am totally agree with you that just putting a sentence is not meaningful. :)