#18990 [Com]: [chm] general layout comment

ID: 18990 Comment by: vlcc69jfbo001@sneakemail.com Reported By: marcus@synchromedia.co.uk 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@php.net 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@synchromedia.co.uk [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