Posted by Kamil Nowakowski (kamiln) on 2008-11-18T00:42:12.000+0000
Good idea , i found a lot of information in comments
Posted by Benjamin Eberlei (beberlei) on 2008-11-18T00:48:55.000+0000
Personally i like the djangobook comment style more, which also would fit the Zend Framework manual more.
Posted by Wil Sinclair (wil) on 2008-12-30T07:32:01.000+0000
Matthew has a proposal on how to do this, and we have considered adding this feature to the online version of the docs for a future release.
I also prefer the more localized comments in the Django book, but I think we may be able to do a bit better by classifying the type of comment (e.g., documentation error, warning, note, example, etc.), so that you know what kind of comment/thread you are opening without having to look through a long list of unsorted comments. We might also support comment threads. Also, I propose we require authentication with the tools un/pw to keep the quality of the comments high. O O O, some Dojo widget/animation goodness would be nice!
In short, I think we should provide all the benefits of php.net and the Django book, but do it even better. :)
Posted by Mickael Perraud (mikaelkael) on 2010-03-30T05:15:05.000+0000
This issue has been resolved with ZF 1.10 or do you plan to add something?
Comments
Posted by Kamil Nowakowski (kamiln) on 2008-11-18T00:42:12.000+0000
Good idea , i found a lot of information in comments
Posted by Benjamin Eberlei (beberlei) on 2008-11-18T00:48:55.000+0000
Personally i like the djangobook comment style more, which also would fit the Zend Framework manual more.
Posted by Wil Sinclair (wil) on 2008-12-30T07:32:01.000+0000
Matthew has a proposal on how to do this, and we have considered adding this feature to the online version of the docs for a future release. I also prefer the more localized comments in the Django book, but I think we may be able to do a bit better by classifying the type of comment (e.g., documentation error, warning, note, example, etc.), so that you know what kind of comment/thread you are opening without having to look through a long list of unsorted comments. We might also support comment threads. Also, I propose we require authentication with the tools un/pw to keep the quality of the comments high. O O O, some Dojo widget/animation goodness would be nice! In short, I think we should provide all the benefits of php.net and the Django book, but do it even better. :)
Posted by Mickael Perraud (mikaelkael) on 2010-03-30T05:15:05.000+0000
This issue has been resolved with ZF 1.10 or do you plan to add something?