Page 1 of 1
phpdoc interface and/or implementing classes
Posted: Mon Apr 20, 2009 1:47 pm
by koen.h
In order to avoid duplicate phpdocumentation I would only comment the interface. But I have no idea what the standard is. Seems to me that commenting the class itself is indispensible when you need to explain things that are specific to the implementation. But that opens up a lot of duplicate documenting. I've always been a very lazy documentor and am looking to change that.
Re: phpdoc interface and/or implementing classes
Posted: Mon Apr 20, 2009 1:54 pm
by Christopher
And your question is?

Re: phpdoc interface and/or implementing classes
Posted: Mon Apr 20, 2009 11:49 pm
by koen.h
To document both interface and implementing classes or not?
Re: phpdoc interface and/or implementing classes
Posted: Tue Apr 21, 2009 2:19 am
by Christopher
I'd say document both because they are different. One is the interface and the other is what is behind it.