Take a look at the documentation of zeromq [1]. This is one of the best documentations I've read so far. You may notice a simple pattern in the structure of tha

Take a look at the documentation of zeromq [1]. This is one of the best documentations I've read so far. You may notice a simple pattern in the structure of that documentation that starts with describing a problem, then follow with an explanation and/or a solution with examples. This is a simple enough mantra to have and I personally following that every time I try to document or explain something. Always start with a problem. Problems are interesting. [1] http://zguide.zeromq.org/page:all http://zguide.zeromq.org/page:all