Re: comment on version 6
| From: | Biranit Goren | Date: | Mon, 15 Jul 2002 20:00:02 +0000 |
| Subject: | Re: comment on version 6 | ||
| References: | 1 2 3 4 | Groups: | php.doc.chm |
| Request: | Send a blank email to php-doc-chm+get-279@lists.php.net to get a copy of this message | ||
Gabor,
Again - thank you.
Just one comment, something I've learned from my experience in providing a service to a vast
number of users:
If a feature isn't obtrusive (doesn't come at the expense of a different feature), there
is no reason to remove it simply because not EVERYBODY uses it.
The page location navigation may have not scored high on your feedback survey, but it's not an
obtrusive feature - and even if just a few (like me :p) find it useful, then why not keep it? Those
who don't use it won't suffer because of it, and those who do will benefit from it.
As for point #1 (Purpose/Usage/Availability): I believe the manual should serve both experienced and
inexperienced users. I learned a LOT of my PHP through the CHM file, and the clarity of the
Purpose/Usage/Availability was incredibly helpful.
Furthermore, even now that I am experienced and use the manual as reference/refresher, the layout
helps me to view in a fly the information I need. More often than not, I simply stumble on a
"Usage" memory block - and fire up the CHM to refresh my memory. Having the text in the
version 2 format makes it clearer, in my opinion.
Make it simple, clear, and clean. That should be the moto in my opinion :)
Thank you for your time,
Biranit
*********** REPLY SEPARATOR ***********
On 15-Jul-02 at 21:37 Gabor Hojtsy wrote:
>> * See how the function's Purpose/Usage/Availability is better - and more
>> clearly - displayed in v2;
>> * The above page location (Main > Function Reference > etc) is very
>helpful
>> for someone like me, and is entirely missing in v6
>> * The icons (path to this page, online functions, jump to user notes,
>etc)
>> were also at times helpful and I'm sorry you removed them.
>> I hope you will go back to that display format. I believe the display
>(not
>> colours or style!) was much better before.
>
>OK, I can undestand know what you were refering to. I too miss the first
>point
>somehow, though I am somewhat experienced in PHP programming, so I do not
>need
>that detailed information much of the time. Most of these changes were made
>after examining the results of our survey, and it pointed out, that these
>navigational elements are not that important. Much of these are available
>though at the bottom of the page. "Report a bug", or "This page online" are
>functions needed before the page is read as far as I think...
>
>> I would like to add my thank you on this occasion for your and everyone's
>> efforts in making this tool. I have been using it since it was first
>> introduced and have become very dependent on it in my work. If I am
>> 'bickering' on such issues as above, it's only because I like it so much.
>
>I do love to hear any comments on the current CHMs, as it shows that it is
>used actively in production. No feedback is much worse then back feedback
>in my mind :) But I would like to ask other's what is their opinion about
>this thing?
>
>Goba
--------------------------------------
Atlas F1
The Journal of Formula One Motorsport
http://www.atlasf1.com