Re: comment on version 6

From: 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

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