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 think make it really harder to read on the first view. I understand that we don't want to restart everything from scratch so here is what I would do to make it better (from my point of view): - Use 100% of the screen width (instead of the current 75%) move the navigation (layout-menu) on the left of the screen, remove the floating (#quicktoc) to get more space to display usefull content. - Remove margin/padding in a lot of spaces to make it a little bit more compact (and display more data on one screen) - Add the next/previous/up buttons (I don't think there are on the prototype or I can't find them) In my point of view, the current status of the beta site is not usable enough to replace definitivly the current version. One of the good thing about PHP is its documentation and I think it replacing the current one with the prototype will make it less usable and then less enjoyable to read. My 2 cents :) Pierrick On 28 December 2012 16:46, Philip Olson <phi...@roshambo.org> wrote: > Hello everyone, > > What do people think about the PHP manual layout? Let's compare three > versions: > > 1. Current site: > > http://www.php.net/manual/en/function.json-decode.php > > 2. Current prototype (which may launch January 2013): > > http://prototype.php.net/manual/en/function.json-decode.php > > 3. An old example based on sphinx (via Python): > > http://moacirdeoliveira.com/phd/sphinx/function.json-decode.html > > Please sift through these three examples (and maybe others, for other > projects) > and determine how we should proceed. The beta/prototype site will go live > within > a month or two so let's be ready. Let's improve the prototype. > > For me, when evaluating the prototype, this means: > > 1. Improving contrast. The current site hurts my eyeballs. This is why > the sphinx (3) example above is so nice. > > 2. Tighter (less) whitespace, especially for code highlighting. > > Mainly it's the lack of contrast. If given the choice (as a user preference > on the site) I'd use the sphinx version for this reason, although I don't > believe this is a real choice. > > What say you? > > Regards, > Philip >