-- Mike Wright <[email protected]> wrote (on Tuesday, 17 April 2012, 11:50 AM -0700): > I've had recurring problems navigating the API documentation, > specifically the left iframe with id = 'sidebar' being fixed width > and IMO way too narrow.
First, to address the iframe concern: we chose this in part to reduce the overall size _per_ _page_; without the iframe, you have to load the menu list on each and every page you view within the API documentation. This is a far, far worse situation than using iframes, considering the size of the menu. > Again, in my experience learning to write for the web, I've found > that fixed widths have their place in the paper and ink world and in > complicated graphic paste-ups, but fail completely in the world of > browsers where users have different sized monitors and DPIs and > ignores the reality that in graphical envirnments windows can be > scaled. > > I'd like to recommend that this file be modified: > > http://framework.zend.com/apidoc/core/css/default.css > > specifically, line 14, to change fixed to proportional width. > Hacking showed that a width of 30% to 35% rendered a much more > usable menu. Considering that the right iframe with id = 'content' > is mostly white-space on its right side nothing would be lost and > site navigability enhanced. > > This was tested with Firefox 11 but I'm pretty sure this will work > on all browsers. > > My 2ยข opinion but I'd really like to see it implemented :) As for this suggestion, please post an issue to phpDocumentor at this time (DocBlox and phpDocumentor recently merged efforts, with phpdoc2 being basically what DocBlox created). The template we use is one provided by default with that tool, and I really don't want us to maintain our own template at this time. Thanks! -- 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]
