Re: comment on version 6
| From: | Biranit Goren | 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