Here is the presentation I made on the subject of “Documenting PHP Applications” at PHP|Works in Toronto, on Thursday September 23rd, 2004. It is available in gzip or winzip formats. The presentation itself is in a powerpoint slide show format.
PHP Documentor presentation
Jason Sweat has posted slides of his presentation about documenting PHP applications. Presentation gives a nice overview of PHP Documentor, popular PHP documentation tool. We all know that comments are good thing, and we all love to write them, right :…
Unfortunately there is nothing in the presentation that is not in the PHPDocumentor manual.
Personally I would prefer to look at the source of the SimpleTest documentation!
Unfortunately there is nothing in the presentation that is not in the PHPDocumentor manual.
I agree. My intention was to present the information in a concise and useful format. I hope I have achieved that.
Though it surprised me, this presentation was an introduction to phpdoc for many of the members of the audience.
Personally I would prefer to look at the source of the SimpleTest documentation!
Please do, available via anonymous CVS on sf.net. Feel free to ask questions as well. The tutorial directory is where the docbook stuff resides, and there is an additional cvs module for our modifications to the standard HTPL::frames:DOM/earthli templates in phpdoc_template.
Thanks! That is exactly what I wanted. SimpleTest’s docs/tutorials look really good and I wanted to do the same with my stuff. If I may ask, what editor do you use to write the tutorials?
Cheers, Luis
Dokumentation von PHP Applikationen
Leider hat es sich noch immer nicht
PHP Documentor presentation
Jason Sweat has posted slides of his presentation about documenting PHP applications. Presentation gives a nice overview of PHP Documentor, popular PHP documentation tool. We all know that comments are good thing, and we all love to write them, right :…
Unfortunately there is nothing in the presentation that is not in the PHPDocumentor manual.
Personally I would prefer to look at the source of the SimpleTest documentation!
I agree. My intention was to present the information in a concise and useful format. I hope I have achieved that.
Though it surprised me, this presentation was an introduction to phpdoc for many of the members of the audience.
Please do, available via anonymous CVS on sf.net. Feel free to ask questions as well. The tutorial directory is where the docbook stuff resides, and there is an additional cvs module for our modifications to the standard HTPL::frames:DOM/earthli templates in phpdoc_template.
Regards,
Jason
Thanks! That is exactly what I wanted. SimpleTest’s docs/tutorials look really good and I wanted to do the same with my stuff. If I may ask, what editor do you use to write the tutorials?
Cheers, Luis
vi
or textpad on windows boxen.
Not much of a gui/ide guy myself.
I recall that OpenOffice was supposed to have a docbook authoring mode, but I have not looked into this personally.
The download links are broken.
Whoops, another artifact of the WordPress 1.2.1 upgrade. Thanks for pointing it out!