From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jeff Horn Subject: Re: Re: Worg needs some reorganizing Date: Tue, 18 Jan 2011 20:35:51 -0500 Message-ID: References: <4CAD81B0.6090807@manor-farm.org> <87bp6ytacd.fsf_-_@stats.ox.ac.uk> <87fwsubckf.fsf@gnu.org> <87aaj2w5x4.fsf@fastmail.fm> <87d3nyuhkw.fsf@altern.org> <87aaj0kggo.fsf@gmail.com> <87zkr0load.fsf@riotblast.dunsmor.com> <87pqrwipjd.fsf@gmail.com> <87oc7glhef.fsf@riotblast.dunsmor.com> <87hbd8ins8.fsf@gmail.com> <87ipxolgji.fsf@riotblast.dunsmor.com> <87aaj0iiff.fsf@gmail.com> <87r5cbk28p.fsf@riotblast.dunsmor.com> <87fwsrtokh.fsf@gnu.org> <87fwsrjtnx.fsf@riotblast.dunsmor.com> <87hbd7jr42.fsf@gmail.com> <87k4i2fa7l.fsf@gmail.com> <87vd1mgnip.fsf@riotblast.dunsmor.com> <87k4i2gh08.fsf@riotblast.dunsmor.com> <87lj2ij8g3.fsf@gnu.org> <87lj2h25qo.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Return-path: Received: from [140.186.70.92] (port=39737 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PfMy7-0000jt-QF for emacs-orgmode@gnu.org; Tue, 18 Jan 2011 20:36:17 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PfMy6-0004YM-0R for emacs-orgmode@gnu.org; Tue, 18 Jan 2011 20:36:15 -0500 Received: from mail-fx0-f41.google.com ([209.85.161.41]:49447) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PfMy5-0004Xt-R5 for emacs-orgmode@gnu.org; Tue, 18 Jan 2011 20:36:13 -0500 Received: by fxm12 with SMTP id 12so312179fxm.0 for ; Tue, 18 Jan 2011 17:36:12 -0800 (PST) In-Reply-To: <87lj2h25qo.fsf@gmail.com> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Eric Schulte Cc: Dan Davison , Ian Barton , Jason Dunsmore , Bastien , Matt Lundin , emacs-orgmode@gnu.org, Carsten Dominik On Tue, Jan 18, 2011 at 5:42 PM, Eric Schulte wrot= e: >> I don't have a strong opinion about this: splitting the FAQ into >> org-faq-*.org comes to my mind, but it's a big task. =A0org-info-js, >> while not optimal for *every* page on Worg, was doing a good job >> on the FAQ. > > I'd lean towards keep the FAQ as one large flat html file to encourage > text searching in the browser, although this may be personal preference. I agree. I often navigate the online org monolithic manual using text search. The TOC sidebar helps a great deal for navigating, and it's nice to have anchor links to share a particular section with someone. The case could be made that Google search makes flat/nested FAQs fairly equal. That's why I'm in favor of Google site search instead of the "s" searching currently available. That's how I navigate most sites when looking for something in particular. --=20 Jeffrey Horn http://www.failuretorefrain.com/jeff/