Chunked guide

Ryan Schmidt ryandesign at
Tue Jul 22 02:11:57 PDT 2008

On Jul 22, 2008, at 03:42, Randall Wood wrote:

> On Tue, Jul 22, 2008 at 3:19 AM, Ryan Schmidt wrote:
>> On Jul 20, 2008, at 09:34, markd at wrote:
>>> The only "problem" with the chunked version is you can't
>>> do a browser search of the whole document, but I'm not sure how many
>>> people want that.
>> I was initially going to suggest making a chunked guide because it's
>> what I'm used to from other projects like php and mysql. But since
>> then I've found it convenient to have it all on one page. I do use
>> the browser search feature to quickly determine whether or not the
>> guide mentions a particular topic at all before filing an enhancement
>> request.
>> I can learn to live with a Google search instead. If we make the
>> chunked guide the default, we should provide a Google search box
>> which searches just
> Why not place this across all MacPorts sites?

Searching across more than just does not answer  
the question "Is this in the Guide?" It doesn't even answer the  
question "How do I use this?" For example, I might want search the  
Guide for "build.dir" to see what the default is. But using your  
search, I get a bunch of tickets where build.dir is mentioned, which  
is not what I wanted. If we remove the single-page Guide, or make the  
chunked Guide the preferred Guide, then we need to provide a way to  
search it, and only it.

More information about the macports-dev mailing list