From owner-freebsd-doc@FreeBSD.ORG  Fri Sep 12 07:11:21 2003
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id EE41516A4BF
	for <freebsd-doc@FreeBSD.org>; Fri, 12 Sep 2003 07:11:21 -0700 (PDT)
Received: from mail.ac-net.at (secure.ac-net.at [212.24.125.8])
	by mx1.FreeBSD.org (Postfix) with ESMTP id C7F3643FF2
	for <freebsd-doc@FreeBSD.org>; Fri, 12 Sep 2003 07:11:19 -0700 (PDT)
	(envelope-from shammer@daemon.li)
Received: from localhost (server.ac-net.at [127.0.0.1])
	with ESMTP id CFB253F22
	for <freebsd-doc@FreeBSD.org>; Fri, 12 Sep 2003 16:11:10 +0200 (CEST)
Received: from daemon.li (dsl-154-254.utaonline.at [62.218.154.254])
	with SMTP id 732E73EFC
	for <freebsd-doc@FreeBSD.org>; Fri, 12 Sep 2003 14:11:06 +0000 (UTC)
Received: (qmail 1136 invoked from network); 12 Sep 2003 14:11:27 -0000
Received: from localhost (HELO daemon.li) (127.0.0.1)
  by localhost with SMTP; 12 Sep 2003 14:11:27 -0000
Received: (from shammer@localhost)
	by daemon.li (8.12.6/8.12.7/Submit) id h8CEBQXm001134;
	Fri, 12 Sep 2003 16:11:26 +0200 (CEST)
	(envelope-from shammer)
Date: Fri, 12 Sep 2003 16:11:26 +0200
From: Josef El-Rayes <j.el-rayes@daemon.li>
To: Ceri Davies <setantae@submonkey.net>,
	"Simon L. Nielsen" <simon@FreeBSD.org>,
	Christian Brueffer <chris@unixpages.org>, freebsd-doc@FreeBSD.org
Message-ID: <20030912141126.GC1068@daemon.li>
References: <200309120920.h8C9KGZ8091585@freefall.freebsd.org>
	<20030912093107.GH635@unixpages.org> <20030912093846.GK76802@submonkey.net>
	<20030912103331.GA388@FreeBSD.org> <20030912111813.GA75659@submonkey.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20030912111813.GA75659@submonkey.net>
User-Agent: Mutt/1.4.1i
Reply-Path: j.el-rayes@daemon.li
X-Operating-System: FreeBSD 4.8-STABLE
X-Virus-Scanned: by AMaViS 0.3.12 with AC-networks extensions
Subject: Re: docs/56729: [patch] artciles/pr-guidelines: explain meaning of
	MFC
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
Reply-To: j.el-rayes@daemon.li
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 12 Sep 2003 14:11:22 -0000

Ceri Davies <setantae@submonkey.net> wrote:
> Yeah, those are the lines I was thinking along.
> My reference to "relevant elements" was that there are very likely <glossary>
> elements or similar already, which we can make use of.

i wanted to start collecting some terms for glossary as some questions
arose:

i am wondering on how to realize this. should it be more of an index,
with a crosslink to the place where it gets explained or like this:

MFC: ...merge from current, action... <a href="..">read handbook..</a>

with a short explanation and a link when there is a place where it gets
explainend more detailed.

should there be a certain "treshhold" like, only use freebsd specific
terms or not trivial terms or should we include every term like "unix,
ports, packages..."?

-josef
-- 
www: http://www.daemon.li
nic-hdl: JER1080312-NICAT
BSD in AT: www.bsdcode.at
"Make World - Not War!"