| Summary | API calls definitions automatically rendered as wiki pages |
| Queue | Wicked |
| Type | Enhancement |
| State | Accepted |
| Priority | 1. Low |
| Owners | Chuck Hagenbuch <chuck (at) horde (dot) org>, Jan Schneider <jan (at) horde (dot) org> |
| Requester | Duck <duck (at) obala (dot) net> |
| Created | 01/21/2008 (230 days ago) |
| Due | |
| Updated | 07/06/2008 (63 days ago) |
| Assigned | 02/14/2008 (206 days ago) |
| Resolved | |
| Attachments | api.php ![]() wiki.jpg ![]() explain[1].tgz ![]() collection.php ![]() |
| Milestone | |
| Patch | No |
New Attachment: collection.php
documentation even for apis without "provides" configured in registry
and notify that this methods can be called only locally with
callByPackage().
everything in explain.tgz?
more configurable.
State ⇒ Feedback
everything in explain.tgz?
State ⇒ Accepted
Queue ⇒ Wicked
New Attachment: api.php
the page prefix and to add or not the api version to pagename. Of
course you should change it to swit your wishes.
State ⇒ Feedback
framework, including proper credits to Sergio Carvalho and a few
coding style tweaks. The Wiki driver should still be changed to *not*
mess with the method names. I see why this is necessary for the
(external) API documentation, but it doesn't help if this should
become a general purpose package. Instead, a subclass could hook into
the method name processing.
I changed my mind and would like to see this script added to
wicked/scripts/. By default, it could be run in any Horde installation
to autogenerate API docs of the currently installed Horde apps.
I would like it to generate the following wiki page structure. The
prefix should be editable in the script header, so that we would
create everything below /Doc/Dev/Apis/, a sane default might be
/HordeApis/:
Apis (or HordeApis) - contains the instructions how to call the api
methods. The RPC package has more example that have just been added by
Chuck. Additionally in contains a list to all application sub-pages,
e.g.:
Apis/KronolithApi - contains a list of versions. The idea is to allow
to keep track of different application versions. Thus the script
should not rewrite this page completely, but only add new versions as
it detects them.
Apis/KronolithApi/2.2-cvs - contains the actual API docs. This could
safely be overwritten. If run on a stable version, it won't change
anyway, and if run on a cvs version, it properly updates the docs.
Queue ⇒ Horde.org Servers
New Attachment: explain[1].tgz
- Avoid warnings with no documentation.
- Tell if method has missing documentation.
though.
or browse around for docs as they can find it on our partner pages. So
I think it can be done the same here. Add them in the already existing
crontab documentation update to update Horde Wiki pages or/and add
them on the webpages as "External methods" in the documentation
section (something like http://www.horde.org/imp/docs/?f=api.html)
State ⇒ Feedback
though. And you probably need to update it because I changed the API
methods a bit. The CSS links are no longer returned by the display
method.
New Attachment: wiki.jpg
New Attachment: explain.tgz
Queue ⇒ Wicked
Summary ⇒ API calls definitions automatically rendered as wiki pages
Type ⇒ Enhancement
Priority ⇒ 1. Low
State ⇒ New
modules API documentation in HTML or WIKI format. Using together with
#6130patch (also included) you can easy update/create wiki pages withAPI call descriptions.