On Thu, Sep 19, 2013 at 9:46 AM, Martin Sustrik <sustrik@xxxxxxxxxx> wrote: > We definitely need examples in as many languages as possible. Once we have > examples in 2+ languages we can think of how to make them more accessible to > users. The way ZeroMQ guide does it (generic text + examples in different > languages) seems to be a viable option. It's pretty easy for users to use > and it also makes it easier for non-english-speakers and people not > comfortable at writing English text in general to contribute examples. Yeah, I think guide-like docs would definitely be good to have. Personally, I like Sphinx quite a bit. How about setting up a Sphinx project that has both the reference docs and more guide- or tutorial-like documentation? Cheers, Dirkjan