hi baiju, if it can be determined programmatically that viewletManager is defined by zope.viewlet, maybe exceptions could be caught at some high level, analyzed, and injected with a novice-friendly list of the possible sources of the undefined symbol. maybe this could be a service of zope.org or pypi, or just part of the standard zope download. i would think that this wouldnt affect performance, since the exception would otherwise be uncaught. but i'm a novice myself, i dont know if this is feasible or advisable. however, i do like the idea of giving folks info when they need it, as opposed to docs, which can seem useless when one is unsure of where to even begin looking.
john Baiju M wrote: > On Wed, Mar 24, 2010 at 10:32 AM, Stephan Richter > <[email protected]> wrote: > >> On Wednesday 24 March 2010, Baiju M wrote: >> >>> I am working on "ZCML Directives" wiki page now: >>> http://wiki.zope.org/bluebream/ZCMLDirectives >>> >> Why are you doing this? apidoc auto-generates this for you. All you need to >> do >> is to write a script that uses the apidoc API to generate a ReST file and you >> are done. >> >> http://apidoc.zope.org/++apidoc++/ >> >> Click on ZCML Reference. >> >> In general I would suggest making apidoc work on bluebream instead of >> recreating new reference documentation. >> > > I agree that we need auto-generated API documentation. > > I also got motivation to write hand-written documentation from BFG > ZCML documentation: http://docs.repoze.org/bfg/current/zcml.html > I am not sure whether they auto-generated it or not. But it looks > very good. I am trying to achieve something similar. > > We need to think about how to organize it. Wiki is a good place to start > that. > For example, sometimes back someone asked me in IRC that he is getting > an error related to "viewletManager". I suggested him to include > "zope.viewlet" > I was thinking how can I avoid these kind of questions from someone > looking to BlueBream, then I got an idea to create a "ZCML Directive Chart" > which is included in the current documentation. So, I think we need to > organize documentation in such a way that it will be more useful and > effective. So, I am looking for your suggestions :) > > Anyone volunteer to write examples for all ZCML directives ? > > P.S: Today is holiday for us (http://en.wikipedia.org/wiki/Rama_Navami), > so I am going to work on this documentation. If anyone want to join, > please come to IRC. > > Regards, > Baiju M > _______________________________________________ > bluebream mailing list > [email protected] > https://mail.zope.org/mailman/listinfo/bluebream > _______________________________________________ bluebream mailing list [email protected] https://mail.zope.org/mailman/listinfo/bluebream
