-- Jawad Stouli <[email protected]> wrote (on Saturday, 16 April 2011, 06:06 PM +0200): > 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.
I've forwarded the above on to Mike at the DocBlox project. I believe he's already addressed (2) in some recent changes he's been working on, but (1) makes a lot of sense as well, and should be trivial to accomplish. > 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. Could you provide the following: * What browser are you using? * What are the default font and font size you're using in your browser? * If possible, could you also take a screen shot and link to it? That will help us better diagnose what the issue is and whether or not it can be addressed. Thanks! > 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] > > > > > > -- 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]
