apidoc rootmodule registration should be automatic
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
BlueBream |
New
|
Undecided
|
Unassigned | ||
Zope 3 |
Won't Fix
|
Undecided
|
Unassigned | ||
zope.app.apidoc |
New
|
Undecided
|
Unassigned |
Bug Description
the root module that currently appear in the ++apidoc++ code browser are those registered in:
zope/app/
<apidoc:
<apidoc:
<apidoc:
<apidoc:
<apidoc:
<apidoc:
<apidoc:
<apidoc:
<apidoc:
First problem: ZODB rootmodule, ZConfig rootmodule, etc. should not be registered here.
zope.app.apidoc should not depend on there modules.
Second problem: other modules such as the instance or buildout development modules don't appear in the apidoc. They have to register themselves with an apidoc:rootModule directive.
---
First solution : remove these registrations from zope.app.apidoc, and move them into each module. This means that every module will depend on zope.app.apidoc, this is not acceptable.
Second better solution : let zope.app.apidoc discover itself all the root modules. How can we do that?
Changed in zope3: | |
status: | New → Won't Fix |
i want learn linux