Chunked guide

[Randall Wood]

On Tue, Jul 22, 2008 at 5:11 AM, Ryan Schmidt <ryandesign at macports.org> wrote:
>
> 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.
>
>
Are the topical searches within results not showing the guide? (Now  I
just need to figure out how to get a topical search to be the default
one...)



-- 
Randall Wood
randall.h.wood at alexandriasoftware.com

"The rules are simple: The ball is round. The game lasts 90 minutes.
All the rest is just philosophy."