Re: comment on version 6

From: Date: Mon, 15 Jul 2002 18:24:33 +0000
Subject: Re: comment on version 6
References: 1 2  Groups: php.doc.chm 
Request: Send a blank email to php-doc-chm+get-277@lists.php.net to get a copy of this message
Hi Gabor, Thanks for your detailed reply - I appreciate this. I won't further pursue the search issue, as I am aware of the advantages of having the user notes in a separate file - and if the disadvantage of it means duplicate search results, then so be it. As for the design issue: I may not have been clear myself, I apologise. What I was referring to is how the text is presented and the functionality of the top menu, rather than colours or style. I enclose an image of the same page in both version 2 and version 6 (the function was randomly selected) - I think once you look at them one next to the other, you will understand exactly what I mean when I said it was clearer before. * 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. 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. Looking forward to your comments, Biranit *********** REPLY SEPARATOR *********** On 15-Jul-02 at 12:52 Gabor Hojtsy wrote: >> 1) I am really missing the beauty of version 2. Of all version, >> it remains the best looking and most clear manual display you used. > >We plan to offer a way to customize the look and feel yourself with >both CSS and JS "skin files". There will be no skin editor though... >There were much more alarming notes on the version 2 design, than >"love letters" about is, so we decided to drop out that one. > >> 2) What annoys me immensely is that when I do a search, the user >> notes appear separately. For example, searching for "GetImageSize" >> will return the following titles: >> >> N: getimagesize >> getimagesize >> ... >> etc... >> >> This is an unnecessary duplication that bloats the list of topics >> and in some cases makes it very hard to find what you were looking for. >> There is no reason to separate the user notes from the topic in the >> search list - it makes the manual much less user friendly than it was >> before. > >I beleive that there are more people who woule like to get results for >manual pages and user notes separately, as much of the guys treat manual >content a more comprehensive resource then user notes. Technically there >is no way to *not* get results separately and put the notes in a separate >file the same time. > >Putting the notes into a separate file enables users to delete the notes >file if they are not interested in notes, or use one note file for several >different languages of the PHP manual. I beleive this is a great help >for international users, as they won't not need to download the notes with >each of the languages they download (most commonly the English one and >their natural language). This also enables users to upgrade the two files >separately. The generation time of the user notes and manual CHMs probably >won't be syncronized on php.net, as the user notes file will be updated >more often then manuals (I guess). > >The separate search results are a side effect of the user note separation, >and I do thought that this is even better for users. It would be nice to >hear other thoughts, though it's unlikely that I'll be able to merge the >search results somehow. > >BTW you always have the ability to group search results by cliking on the >location headline. > >Goba -------------------------------------- Atlas F1 The Journal of Formula One Motorsport http://www.atlasf1.com

« previous php.doc.chm (#277) next »