[PHP-DOC] #18990 [Com]: [chm] general layout comment From: vlcc69jfbo001 <email protected>
Date: 11/04/02

 ID: 18990
 Comment by: vlcc69jfbo001 <email protected>
 Reported By: marcus <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] iliaa <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] marcus <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