Hello, Good to see that those small issues hiding the good work are to be resolved !
I would like to add three other suggestions : 1. Left frame : the classes are not alphabetically ordered (for instance in Zend\View\Helper). It is really difficult to find a specific class. 2. The list of the methods generated in the "summary" of a class is quite unusable. Maybe some simple breaks may help there. 3. The right block "Properties" is very small on my screen and it's hard to see it and use it. It could be a part of the whole page, before the details on the functions. Thanks for your great work on ZF! Jawad On Fri, Apr 15, 2011 at 4:47 PM, Matthew Weier O'Phinney <[email protected]>wrote: > -- Cristian Bichis <[email protected]> wrote > (on Friday, 15 April 2011, 05:34 PM +0300): > > I am having the same "issues" with the DocBlox and i have some > suggestions: > > 1. Left frame is too small or maybe fonts are too large... Try to > > navigate to Zend\View\Helper and you going to see lot of wrapped > > class names, is hard to read... > > > > Either making larger the left frame or reducing font sizes may help... > > > > 2. The format from the right column was much more easily to > > "read"with the old phpDocumentor, i think especially due to using > > diff colors for some of the parts of the documentation (constants or > > member variables or so if i recall). > > Mike van Riel (lead on the DocBlox project) has been working on both of > these, to my knowledge, and we may be rolling out a new version in the > next week or so. > > > Cristian > > > -- ZED MASTER<[email protected]> wrote > > > (on Friday, 15 April 2011, 09:58 AM -0300): > > > > Why have you changed the format from the API documentation? > > > For a variety of reasons: > > > > > > * Moved to an actively developed project (DocBlox) that not only > works > > > for PHP 5.2 and below but also for PHP 5.3 (important as we move > > > towards ZF2). > > > * Speed and resource usage. phpDocumentor took 80-100 minutes minimum > > > -- when it didn't consume all available RAM. DocBlox renders in > less > > > than 10 minutes and is very resource-conscious. > > > * Ability to modify templates. phpDocumentor's templating system was > > > not well documented, and it was incredibly difficult to modify. > > > DocBlox is more flexible -- as you'll see in the coming weeks. > > > > > > >It was confusing and hard to see. > > > Can you please be more specific so that we can address the concerns? > > > This is too vague to enable us to make any meaningful chanegs. > > -- > Matthew Weier O'Phinney > Project Lead | [email protected] > Zend Framework | http://framework.zend.com/ > PGP key: http://framework.zend.com/zf-matthew-pgp-key.asc > > -- > List: [email protected] > Info: http://framework.zend.com/archives > Unsubscribe: [email protected] > > >
