[BlueBream] ZCML Directives wiki page

John john at saponara.net
Wed Mar 24 15:20:56 EDT 2010

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.


Baiju M wrote:
> On Wed, Mar 24, 2010 at 10:32 AM, Stephan Richter
> <stephan.richter at gmail.com> 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
> bluebream at zope.org
> https://mail.zope.org/mailman/listinfo/bluebream

More information about the bluebream mailing list