Suggestion add a non-normative "usage notes" section to the specification

[anotherlin]

There's a lot of subtleties in UDP, TCP, and the network programming in general. For instance, what is "half closed state" and actual "closed state".

However, those explanations would not be needed in the actual specification, and would even clutter it. So it would be great to have a small section, perhaps with more examples, to explain some finer points of usage of the API.

[ClaesNilsson]

Sounds like a good idea Ke-Fong. This could be an informative section in the beginning of the specification or an informative appendix. May I ask if you would be able to write this section?

[anotherlin]

I'll be glad to do that.

[ClaesNilsson]

Thanks!