[BlueBream] apidoc ? onlinehelp ? preference ?
astoon.net at gmail.com
Fri Apr 23 15:10:26 EDT 2010
2010/4/23 Christophe Combelles <ccomb at free.fr>
> 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,
> and even the project packages. There is probably a few changes to do in
> registrations. A very good thing would then be to move it to zope.apidoc
We need this, it is powerfull tool, and developer can include apidoc in any
moment. But I think, developer needs these features mostly in
_some_context_, i.e. to inspect components "on fly", not just to see docs.
The more so the documentation should be moved out the doctests in future,
yes? In this case displaying them via wsgi-server is not the best idea...
there are editors, Sphinx, etc. Summary, lets' divide:
1) Need to see dynamic data - i.e. components, relations between them.
2) Need to see static documentation.
For dynamic data - inspect registry. Sometimes, we dive into exist zope3
project and "I am feeling that somewhere registered adapter, but where he,
is the devil...".
There is a way to enable it only in devmode with zcml:condition="have
> I think we can provide at least two buildout files for this purpose, one
> production, one for development using devmode and apidoc. It can be easily
> with the templating system currently included.
BlueBream is server-side software. When I create project, I need deploy this
project on my sandbox and on server, in any case. So, I spend time for
production-server-boilerplates, copy-past from older projects :)
Then we need decide:
1) We provide the simple and policy-free template
2) Or we provide powerful template for server-side projects. It can be
relatively polcy-free, I think.
If there is a way to do this without needing the templating, I would be +1
> remove the templating.
alternative - zcml in .cfg files - here is example:
But it seems, templates is better... I'm not sure exact... Personally for
me, these big and mess buildout.cfg files is bad. And system administrators
not liked this, I know (because we need provide instructions how to edit
these files, remove or add bootstrap manager and etc.)
> Same question for zope.app.onlinehelp and zope.app.preference ?
> bluebream mailing list
> bluebream at zope.org
Ilshad R. Khabibullin
+7 922 600 56 06
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the bluebream