ID:               18990
 Comment by:       [EMAIL PROTECTED]
 Reported By:      [EMAIL PROTECTED]
 Status:           Feedback
 Bug Type:         Documentation problem
 Operating System: windows
 PHP Version:      4CVS-2002-08-20
 New Comment:

(Changed email address)
Sort of - my confusion was merely that the usage and 
purpose are presented as one block of text which made it 
hard to pick out either usage or purpose quickly.

Surely a function's purpose is a more important thing than 
its usage, and hence should be shown first and be clearly 
separated?

I prefer the layout in the "Header Nostalgia" skin, though 
it suffers a similar problem.

Really excellent docs, BTW.


Previous Comments:
------------------------------------------------------------------------

[2002-10-31 11:41:10] [EMAIL PROTECTED]

Is still still an issue in the 10th edition of the chm documentation
avaliable from http://weblabor.hu/php-doc-chm/ ?


------------------------------------------------------------------------

[2002-08-20 13:00:25] [EMAIL PROTECTED]

[chm date: 2002-08-14]...
Just a note about the layout of the high skin.
I find having the function name and description together in the same
part of the top bar quite confusing. I keep expecting the function
definition to appear just under the bar. Perhaps at the top of the
body, or in a separate bar below the description would be better.
Either way, I find having it looking like just a second line of the
description is misleading.

------------------------------------------------------------------------


-- 
Edit this bug report at http://bugs.php.net/?id=18990&edit=1


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

Reply via email to