PHP class documentation

Love the tool. I like the markup style, which is less intrusive than the javadoc style to my way of thinking.

The weakness, as I see it, compared to the main competition (www.phpdoc.de) is that ezphpdoc doesn't show the class hierarchy. If you get around to upgrading the script, perhaps you would consider adding this facility.

I think that after using this tool for a little while that it is an extremely good and powerful little tool. One that I will be using for all of my PHP documentation now.

I also like the tutorial very easy to read and gets straight to the point. Although I would like to point out some problems that I had and tok me a while to figure out.

1. Cannot have an index class in a file called index.php. As the generator puts the class list in a file called index.html and puts the documentation for the index class into index.html (copies the name of the php file.) These two then overwrite one another.

2. Cannot have a space before the declaration of the class. class needs to be the first character on the line, otherwise the tool cannot find the name.

3. There is no description of how to insert the version in the tutorial. Just need to check out the source code in th example.

Overall I love it. Keep up the good work!!

I am very impressed with this product. I especially like the ability to view the source code and the ability to switch back and forth b/w code and doco. Well Done!!!

One thing I found missing in the article were some recommendations on what information to put in the documentation. The examples show fairly rudimentary documentation.

We've got the tool to document our code, now let's see some examples of good documentation.

BTW your coding style is a great example to follow.

Check out http://doc.ez.no for our nightly updated php classes. These are documented using what we consider good style.

I will be the first, though, to admit that we haven't been very good at keeping it up, but rest assured, we will slowly get there.