From owner-freebsd-doc Tue Apr 9 14:23:33 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mao.stokely.org (mao.stokely.org [65.84.64.228]) by hub.freebsd.org (Postfix) with ESMTP id 55EA437B416; Tue, 9 Apr 2002 14:23:09 -0700 (PDT) Received: by mao.stokely.org (Postfix, from userid 2074) id 3405B4B669; Tue, 9 Apr 2002 14:23:04 -0700 (PDT) Date: Tue, 9 Apr 2002 14:23:04 -0700 From: Murray Stokely To: Ceri Davies , doc@FreeBSD.org, murray@FreeBSD.org Subject: Re: FAQ and Indexterm finished Message-ID: <20020409212304.GC22329@freebsdmall.com> References: <20020409171830.GA65916@submonkey.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20020409171830.GA65916@submonkey.net> User-Agent: Mutt/1.3.25i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On Tue, Apr 09, 2002 at 06:18:30PM +0100, Ceri Davies wrote: > Big ol' patch at http://www.submonkey.net/patches/faq.full.diff I think a lot of these secondary indexterms are unnecessary. For example, IOMega Zip Drive, etc. That's not really a high level topic with lots of subtopics. I would change some of those very specific things to just primaries without a secondary indexterm. If you look in a normal book index, you will see mostly primary indexterms and indexterms with secondary entries are usually in the minority. In this patch, they make up 100% of the indexterms, which is not ideal. and are available when the organization of the content requires it -- you shouldn't feel obligated to give every index term a two-tier designation. I think sendmail should be a primary, not a secondary under software. Somewhere under the "mail" or "email" entries there should be a to sendmail. grep the Handbook for examples of usage. It is much more likely that someone is going to look under sendmail for this information in the Index. For some of these, you may want to add a or element to the index easier to follow. > I realise that it's not the most beautiful thing ever, but if I > get this in, then I'll be more than happy to see people help out > with tidying it up. It's great work, so feel free to commit it with or without my suggestion above. - Murray To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message