[#6131] API calls definitions automatically rendered as wiki pages
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 Download
wiki.jpg Download
explain[1].tgz Download
collection.php Download
Milestone
Patch No

History
07/06/2008 Jan Schneider State ⇒ Accepted
 
05/05/2008 Duck Comment #12
New Attachment: collection.php Download
Reply to this comment
A updated version of collection.php script from explan.tgz. Create 
documentation even for apis without "provides" configured in registry 
and notify that this methods can be called only locally with 
callByPackage().
05/05/2008 Duck Comment #11 Reply to this comment
With Horde_Reflection in CVS, does the api.php script replace
everything in explain.tgz?
Not really. But uses Horde_Reflection instead of its own class and is 
more configurable.
04/25/2008 Chuck Hagenbuch Comment #10
State ⇒ Feedback
Reply to this comment
With Horde_Reflection in CVS, does the api.php script replace 
everything in explain.tgz?
02/17/2008 Chuck Hagenbuch Assigned to Chuck Hagenbuch
 
02/17/2008 Chuck Hagenbuch Comment #9
State ⇒ Accepted
Queue ⇒ Wicked
Reply to this comment
Sounds like we should move this back to the Wicked queue.
02/17/2008 Chuck Hagenbuch Comment #8 Reply to this comment
A wiki script with Horde_Reflection from framework.
It'd be great if this used Horde_Argv instead of Console_Getopt :)
02/15/2008 Duck Comment #7
New Attachment: api.php Download
Reply to this comment
A wiki script with Horde_Reflection from framework. Allows to specify 
the page prefix and to add or not the api version to pagename. Of 
course you should change it to swit your wishes.
02/15/2008 Jan Schneider Comment #6
State ⇒ Feedback
Reply to this comment
I added the Horde_Document classes as a Horde_Relection package to the 
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.

02/14/2008 Jan Schneider Assigned to Jan Schneider
 
02/14/2008 Jan Schneider State ⇒ Assigned
Queue ⇒ Horde.org Servers
 
01/31/2008 Jan Schneider Deleted Attachment: explain.tgz
 
01/31/2008 Duck Comment #5
New Attachment: explain[1].tgz Download
Reply to this comment
- Handle multiple parameter types.
- Avoid warnings with no documentation.
- Tell if method has missing documentation.
01/24/2008 Duck Comment #4 Reply to this comment
This looks really nice! I wonder how/where we should integrate this
though.
I found it useful for outside partners not needing to look at the code 
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)
01/23/2008 Jan Schneider Comment #3
State ⇒ Feedback
Reply to this comment
This looks really nice! I wonder how/where we should integrate this 
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.
01/21/2008 Duck Comment #2
New Attachment: wiki.jpg Download
Reply to this comment
Rendered page example.
01/21/2008 Duck Comment #1
New Attachment: explain.tgz
Queue ⇒ Wicked
Summary ⇒ API calls definitions automatically rendered as wiki pages
Type ⇒ Enhancement
Priority ⇒ 1. Low
State ⇒ New
Reply to this comment
A set of batch script using PHP5 Reflection API to render horde 
modules API documentation in HTML or WIKI format. Using together with 
#6130 patch (also included) you can easy update/create wiki pages with 
API call descriptions.