Chunked guide

[Ryan Schmidt]

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 macports.org 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 guide.macports.org.
>
> Why not place this across all MacPorts sites?
> http://www.google.com/coop/cse?cx=011837386708472035020:5lqtx6zp3qw

Searching across more than just guide.macports.org 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.