On Sat, Jul 10, 2010 at 7:16 AM, Pieter Hintjens <[email protected]> wrote: > On Sat, Jul 10, 2010 at 7:38 AM, Martin Sustrik <[email protected]> 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 source code > because it acts as a reference. What I'd suggest is that the > generated docs be included in the source tree, and rebuilt regularly > (daily?) when there are changes, and the HTML uploaded to github for > public inspection. This means if you grab the git you get the docs, > and each branch can have its own docs. >
I think that github will make maintenance easy for it. > Downside: someone (Peter?) has to automate this and if the > auto-generation isn't done regularly, the docs become > counter-productive. > Right, this can/will be automated per commit by a github provided api hook, or timely like daily or so. > -Pieter > _______________________________________________ > zeromq-dev mailing list > [email protected] > http://lists.zeromq.org/mailman/listinfo/zeromq-dev > _______________________________________________ zeromq-dev mailing list [email protected] http://lists.zeromq.org/mailman/listinfo/zeromq-dev
