Re: [zeromq-dev] Documentation Proposal

2010-07-10 Thread Pieter Hintjens
On Sat, Jul 10, 2010 at 7:38 AM, Martin Sustrik sust...@250bpm.com wrote: There are several possible advantages of this: Agreed. As for the actual publishing of the docs, I've been thinking about it a bit and here are my thoughts... Makes sense, but I'd include the generated docs with the

Re: [zeromq-dev] Documentation Proposal

2010-07-10 Thread Peter Alexander
On Sat, Jul 10, 2010 at 1:38 AM, Martin Sustrik sust...@250bpm.com wrote: Pieter Hintjens wrote: On Fri, Jul 9, 2010 at 11:08 PM, Peter Alexander vel.ac...@gmail.com wrote: http://travlr.github.com/zeromq2/ Peter, it looks really nice and this looks like the right way to host the generated

Re: [zeromq-dev] Documentation Proposal

2010-07-10 Thread Peter Alexander
On Sat, Jul 10, 2010 at 7:16 AM, Pieter Hintjens p...@imatix.com wrote: On Sat, Jul 10, 2010 at 7:38 AM, Martin Sustrik sust...@250bpm.com wrote: There are several possible advantages of this: Agreed. As for the actual publishing of the docs, I've been thinking about it a bit and here are

Re: [zeromq-dev] Documentation Proposal

2010-07-10 Thread Martin Sustrik
Peter Alexander wrote: 1. It doesn't make sense to distribute the generated docs with the package. Packages are for users. Users don't need detailed code documentation. Developers, on the other hand, are presumably not using packages, rather checking out the recent version from trunk. Its

Re: [zeromq-dev] Documentation Proposal

2010-07-10 Thread Peter Alexander
On Sat, Jul 10, 2010 at 8:06 AM, Martin Sustrik sust...@250bpm.com wrote: Peter Alexander wrote: 1. It doesn't make sense to distribute the generated docs with the package. Packages are for users. Users don't need detailed code documentation. Developers, on the other hand, are presumably not