[PHP-DOC] New CHM manual opinions From: Andrew Braund (andrew <email protected>)
Date: 11/01/01

Great work guys!

Having the online comments is great, there are so many
"gems" in them.

Comments on the Help chm;
I think there are too many colours. The help manual is a daily
workhorse, with blue, orange brown etc it becomes a little too
busy and hard on the eyes.

I also think it would be better to display the background image
less, say only on the main heading pages (rather than on every page,
even the function description detail pages).

I like the faint light blue/grey background, better on the eyes
than white.

I like the new way you have laid out the detail pages, excellent!

The vertical line next to the examples in the details page is
OK but I think just the change of font (to courier?) is enough
to set the example apart.

The Note inside the box with an icon next to it is a waste of
space (sorry). I like the simpler;
Note: magic_quotes_gpc is ON by default.
(with the Note: in bold) as used in the old version of the .chm manual.

I would like to see the "See also" section move to the top of the page
so that is added to the bullet items, so they become;
Purpose:
Usage:
Availability:
See also:

I often find that it is when I read the first few lines of the description
and decide that this was not the function I wanted, that I need to immediately
see the "See also" items so I can go off to the function I really wanted.

Previous, Next, Home and Up links are missing. I like these. Whenever I use
a function from a package that I have not used before I like to scan through
every
function to familiarize myself with the package. The Next link is great for this.

PHP is a great language, the existing Help system is excellent. Your
efforts will make the Help system AWESOME! Keep up the good work.

Thanks and Regards
Andrew Braund

Novato Pty Ltd
Ph +61 8 8370 4950 Fx +61 8 8219 0131 M 0414370015
14 Catharina Street, Flagstaff Hill South Australia 5159