ryandesign at macports.org
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 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
>> 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?
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.
More information about the macports-dev