Re: [PHP-DOC] Fixing the layout/style for man pages

2012-12-29 Thread Levi Morrison
>> 2. Kill the Quick TOC in the documentation. This frees up a lot of >> space, but means we need to find a new home for the language switcher >> and how to report an error. > > We have a pull request on GitHub to deal with this: > https://github.com/php/web-php/pull/8. I'm not crazy about the s

Re: [PHP-DOC] Fixing the layout/style for man pages

2012-12-28 Thread Adam Harvey
On 29 December 2012 07:04, Levi Morrison wrote: > 1. The documentation pages need to be full-page width. They are > far too narrow in their current state. They also need more gutter > room. Weirdly, I think they're more readable in their current state than full width. I seem to be outnumbered

Re: [PHP-DOC] Fixing the layout/style for man pages

2012-12-28 Thread Levi Morrison
Funny you should ask about these things. I was working on prototype.php.net site a lot about a year ago, but then got caught up with my work. Things I believe should be finished before launch: 1. The documentation pages need to be full-page width. They are far too narrow in their current sta

Re: [PHP-DOC] Fixing the layout/style for man pages

2012-12-28 Thread Pierrick Charron
I'm not a huge fan of the new design. Like you said I think it's less readable than the current version or than the sphinx version. There's a lot of lost space on the left and on the right. The prototype in the example (even if it's not a function with a lot of params) is not on one line which I t