Req #55513 [Opn->Bgs]: Improve the appearance of the manual

From: Date: Sat, 27 Aug 2011 23:58:10 +0000
Subject: Req #55513 [Opn->Bgs]: Improve the appearance of the manual
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-7072@lists.php.net to get a copy of this message
Edit report at https://bugs.php.net/bug.php?id=55513&edit=1 ID: 55513 Updated by: rquadling@php.net Reported by: anonymous at anonymous dot anonymous Summary: Improve the appearance of the manual -Status: Open +Status: Bogus Type: Feature/Change Request Package: Documentation problem PHP Version: Irrelevant Block user comment: N Private report: N New Comment: The current CHM file is based upon the same layout as the live documentation. Same HTML layout and CSS styling. The PHP website is currently undergoing a restyling. You can see this at http://www.php.net?beta=1 Behind the scenes, the CHM files (with and without usernotes) are being developed to include the new styling, but these aren't for public consumption just yet. Mainly because the site styling is subject to change. As things stand, there are no plans to introduce additional styling for either the PHP websites or the CHM files. I recently had to shelve a feature to allow third party, external CSS files for the CHM files. There is a limitation on where the CSS files can reside which I felt would be unpopular with users. If you want more details than this, please contact me directly (RQuadling @ php.net). Previous Comments: ------------------------------------------------------------------------ [2011-08-26 17:54:47] anonymous at anonymous dot anonymous Description: ------------ In 2007 I downloaded the "Enhanced" user manual with the user notes. It's been a fantastic resource. I keep it on a hotkey. This download disappeared from the website for a long time so I just kept using the 2007 version. Today I noticed that it's back on the website. I've downloaded it, but I feel like its visual appearance has deteriorated. Compare: Old: http://i.imgur.com/ozinF.png New: http://i.imgur.com/Am2XS.png The old style works very well. It's colorful, clear to read and nicely laid out. You can get the most important function information at a glance. It's not perfect; there are some ways its presentation could be improved, but nothing to get upset about. The new style -- well, maybe I need time to get used to it, but it seems drab by comparison, it doesn't flow as well visually, and most of all it takes up too much screen space for the same content. (That's even though in the screenshot of the new version, I've already reduced the font size from the default.) I think some thoughtful visual optimization of the manual could do wonders to make it more pleasant and more efficient. ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=55513&edit=1

« previous php.doc.bugs (#7072) next »