Re: comment on version 6
| From: | Gabor Hojtsy | Date: | Mon, 15 Jul 2002 10:52:53 +0000 |
| Subject: | Re: comment on version 6 | ||
| References: | 1 | Groups: | php.doc.chm |
| Request: | Send a blank email to php-doc-chm+get-275@lists.php.net to get a copy of this message | ||
> 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