[zeromq-dev] User Guide [WAS: OpenStack cloud API]

[gonzalo diethelm]

> I've started a Talk page, http://www.zeromq.org/docs:user-guide-talk,
> using the wikipedia style.
> 
> It's easiest to edit that page, which is separate.  That way your
> errata and comments will be safe and collected in one place.

I tried editing that page. None of the buttons at the bottom (Cancel,
Show Changes, Preview, Save & Continue, Save) does anything noticeable.
I am using Firefox 3.6.8 on Windows XP SP3 and although I do have
NoScript 2.0 installed, I have allowed all scripts in that page. Any
hints?

In any case, here is my first batch of suggestions (so I won't loose
them).


# Should //inproc// be renamed to //itc// or something? Is this part of
the "big rename" discussion?
# I would create a full Table of Contents, perhaps indicating which
entries are still "To Do". This way we can ascertain the full structure
for the document.
# I would list somewhere the known language bindings and OSs.
# When talking about UDP you say //something as simple as a single
byte... the last byte//; that whole sentence is unclear (to me).
# You say about ZMQ_REQ / ZMQ_REP: //but are slower because of the extra
overhead in keeping the state organized//. Is this noticeable? Is it
worth pointing it out in a User's Guide?
# When discussing ZMQ_PUB / ZMQ_SUB, there is a dangling //asynchronous
messaging// in there.

-- 
Gonzalo Diethelm