Re: Re[2]: [PHP-DOC] New CHM manual opinions From: Markus Fischer (mfischer <email protected>)
Date: 10/29/01

On Mon, Oct 29, 2001 at 09:41:56AM +0100, Hojtsy Gabor wrote :
> > I "old" chm notes, warnings were clearly separated too. I don't think
> > it's good when there is a lot of graphical elements. In the document
> > there must not be anything that impede reading.
>
> You have said nothing about the alternate grouping of function properties,
> the outside links made truly outside, and marked with an arrow... These
> are __not__ only graphics changes. These are conceptual ones... They
> don't just differ in colors from the "old" one.
>
> Do you think that online functions are useless for the common user?

I compared them now a bit more torough (at my best at work):

.) Tables: containing enums and descriptions are much easier to read
in the new manual.

.) Warnings: They were easier to spot in the old manual because
the background of the table had a different color. I think this
should be also in the now one. The little icon with the red text
don't tell much about it being a warning and the text can easily
be overseen.

Contrary, the notes are now easier to spot because of the
surroundin border.

.) Examples: It looks nice with border on the left side but the
visual accentuation with the light gray background color clearer
(at least, to me)

.) External links: Perfect; very well done (conceptional and
visual)

.) See also: very good too

.) Purpose, Usage, Availability: IMHO much better to read (except
the brightened background image)

- Markus