[BlueBream] apidoc ? onlinehelp ? preference ?

Christophe Combelles ccomb at free.fr
Sun Apr 25 04:58:27 EDT 2010


Baiju M a écrit :
> Hi,
> 
> The z.a.apidoc is there in KGS. But it is not configured in the
> default project template. I think projects like ice.control can
> configure it. Otherwise we can include a _new_ admin interface in the
> next release by default.

I agree.
what I would like for BB 1.0 is just having the apidoc, without any admin interface.

> 
> IMO, the new admin interface should not depend on any community
> packages, otherwise those packages should be added to core. Also the
> admin interface should not register any view in the default layer.

For the community packages I would like to add many of them in the community.cfg 
because I always end up using a lot of them, for instance:

z3c.batching
z3c.contents
z3c.coverage
z3c.csvvocabulary
z3c.etestbrowser
z3c.evalexception
z3c.form
(z3c.formdemo)
z3c.formjs
(z3c.formjsdemo)
z3c.formui
z3c.i18n
z3c.layer
z3c.layer.pagelet
z3c.macro
z3c.macroviewlet
z3c.menu
z3c.menu.simple
z3c.optionstorage
z3c.pagelet
z3c.recipe.sphinxdoc
z3c.rml
z3c.skin.pagelet
z3c.table
z3c.template
z3c.testing
z3c.traverser
z3c.viewlet
z3c.viewtemplate
z3c.zrtresource

And zc packages as well

zc.async
zc.blist
zc.catalog
zc.datetimewidget
zc.dict
zc.i18n
zc.monitor
zc.ngi
zc.queue
zc.sourcefactory
zc.twist
zc.z3monitor


Most of them are pulled as dependencies, but I think it is very important to 
include at least :

z3c.form
z3c.formui
z3c.formjs
z3c.pagelet
z3c.layer.pagelet
z3c.template
z3c.macro
z3c.menu.simple
z3c.contents

regards,
Christophe



> 
> Regards,
> Baiju M
> 
> 
> On 4/23/10, Christophe Combelles <ccomb at free.fr> wrote:
>> hi,
>>
>> what about bringing back zope.app.apidoc ? It is a very useful tool during
>> development and it allows to dynamically add other namespaces such as z3c,
>> zc,
>> and even the project packages. There is probably a few changes to do in
>> apidoc
>> registrations. A very good thing would then be to move it to zope.apidoc
>> later.
>>
>> There is a way to enable it only in devmode with zcml:condition="have
>> devmode".
>> I think we can provide at least two buildout files for this purpose, one for
>> production, one for development using devmode and apidoc.  It can be easily
>> done
>> with the templating system currently included.
>>
>> If there is a way to do this without needing the templating, I would be +1
>> to
>> remove the templating.
>>
>>
>> Same question for zope.app.onlinehelp and zope.app.preference ?
>> _______________________________________________
>> bluebream mailing list
>> bluebream at zope.org
>> https://mail.zope.org/mailman/listinfo/bluebream
>>
> _______________________________________________
> bluebream mailing list
> bluebream at zope.org
> https://mail.zope.org/mailman/listinfo/bluebream
> 
> 



More information about the bluebream mailing list