From owner-freebsd-doc@FreeBSD.ORG Mon Dec 6 17:21:29 2004 Return-Path: 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 6290B16A4CE; Mon, 6 Dec 2004 17:21:29 +0000 (GMT) Received: from mail.freebsdmall.com (ns1.freebsdmall.com [69.50.233.146]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3B87B43D5E; Mon, 6 Dec 2004 17:21:29 +0000 (GMT) (envelope-from murray@freebsdmall.com) Received: by mail.freebsdmall.com (Postfix, from userid 2074) id 37F261CDA7; Mon, 6 Dec 2004 09:28:46 -0800 (PST) Date: Mon, 6 Dec 2004 09:28:46 -0800 From: Murray Stokely To: Tom Rhodes Message-ID: <20041206172846.GL78078@freebsdmall.com> References: <20041128202656.GL750@zaphod.nitro.dk> <20041129060320.GA26868@clan.nothing-going-on.org> <20041202203441.GM753@zaphod.nitro.dk> <20041202160251.269d9078@localhost> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20041202160251.269d9078@localhost> User-Agent: Mutt/1.4.2.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: freebsd-doc@FreeBSD.org cc: Nik Clayton cc: "Simon L. Nielsen" Subject: Re: Doc BoF at EuroBSDCon X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 06 Dec 2004 17:21:29 -0000 On Thu, Dec 02, 2004 at 04:02:51PM -0500, Tom Rhodes wrote: > The primer is already very out of date. Once I offered to update > it but that was too great a task and no one from doceng@ seemed > as if they wanted to explicity point out the policy on issues. Browsing through the table of contents and the first few sections, I don't see any thing out of date. No one has stepped forward to write sections on DSSSL or XSLT, but I think it would be better to just have pointers to more authoritative content for those sections anyway. Please explain what is very out of date. This still seems to contain the details of the necessary tools, an overview of an SGML file, and how to edit the DocBook content with our preferred style and wordlist. It's recently been suggested that we add a section to the Primer about not committing works in progress that are significantly beneath the standards of the rest of our documentation set. In the past, that is just something that mentors would explain to new committers and that we'd all explain to contributors through the PR system. - Murray