Dieter Maurer wrote: > Martijn Faassen wrote at 2009-4-10 18:33 +0200: >> Is anyone interested in maintaining Zope 3? > > You should leave a bit more time before you take any drastic actions... > > There are holidays, time of intensive other activity, .....
It'll take time before we all settle on a reasonable way of working, and before everybody has understood what the new way is. That's what I'm trying to do: we're in the process of changing the way this community works. That takes time, but also continuous steps forward. We'll take a gradual path to drastic changes. :) >> ... >> * the thing that has some kind of documentation website - do you care >> about providing documentation for Zope 3 as opposed to documentation for >> Grok or individual libraries? > > I find "http://apidoc.zope.org/++apidoc++/"; very helpful -- for Zope 2 users. > I would not like to loose it.... Agreed. Nobody is proposing we lose it. It's also on docs.zope.org/zope3 - I wonder if there's a difference. But Zope 3 needs more than just api documentation. api documentation is useful but not sufficient to support developers and users that aren't experienced already. It needs something like grok.zope.org, telling people what Zope 3 is about, and how to start using it. Concerning apidoc, I think we should explore how we could make apidoc work without as many dependencies as it pulls in now, though in its very nature it will have to pull in many. It might also be interesting to explore how we could use apidoc in a different way, where instead of supplying api docs for "full stack" system we can do it library-by-library. apidoc right now serves a dual purpose: API provide documentation for the libraries, and an introspector to look at the actual state of the system, whatever is installed.. We should also look about how we can make the individual libraries and apidoc stop talking about "Zope 3" where they do, and just reference the "Zope Toolkit" or not Zope at all. Regards, Martijn _______________________________________________ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
