Req #55513 [Opn->Bgs]: Improve the appearance of the manual
| From: | rquadling@php.net | 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