From owner-freebsd-doc@freebsd.org  Sun Jul  8 01:04:43 2018
Return-Path: <owner-freebsd-doc@freebsd.org>
Delivered-To: freebsd-doc@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id 1056F1044A6C
 for <freebsd-doc@mailman.ysv.freebsd.org>;
 Sun,  8 Jul 2018 01:04:43 +0000 (UTC)
 (envelope-from linimon@lonesome.com)
Received: from mail.soaustin.net (mail.soaustin.net [18.222.6.11])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "mail.soaustin.net",
 Issuer "Let's Encrypt Authority X3" (verified OK))
 by mx1.freebsd.org (Postfix) with ESMTPS id B93CE76A30
 for <freebsd-doc@freebsd.org>; Sun,  8 Jul 2018 01:04:42 +0000 (UTC)
 (envelope-from linimon@lonesome.com)
Received: from lonesome.com (unknown [18.188.142.31])
 by mail.soaustin.net (Postfix) with ESMTPSA id F089824937;
 Sun,  8 Jul 2018 01:04:41 +0000 (UTC)
Date: Sun, 8 Jul 2018 01:04:40 +0000
From: Mark Linimon <linimon@lonesome.com>
To: Sid <sid@bsdmail.com>
Cc: freebsd-doc@freebsd.org
Subject: Re: Documentation should rely on stylesheets for XML not txt tools
Message-ID: <20180708010440.GD27243@lonesome.com>
References: <trinity-c501607c-707c-4784-b4d9-305e2a9be537-1530907599794@3c-app-mailcom-lxa11>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <trinity-c501607c-707c-4784-b4d9-305e2a9be537-1530907599794@3c-app-mailcom-lxa11>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.27
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/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: <https://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 08 Jul 2018 01:04:43 -0000

On Fri, Jul 06, 2018 at 10:06:39PM +0200, Sid wrote:
> Whenever an improvement is suggested for documentation at FreeBSD's
> bugzilla, it sits there for months or even over a year.

Unfortunately this is not limited to doc PRs.  We do a little bit
better at ports due to the "maintainer" concept.

We definitely need more people working on both documentation and
getting PRs fixed.

> Parts of the Handbook are outdated

I'd like to see this situation get fixed.  OTOH I am personally
overcommitted.

If you see anything that is especially stuck, feel free to add me to
the Cc: line.

It is also fair to note that many doc committers are using Phabricator
(https://reviews.freebsd.org) for patch submissions.  My view is that
it's slightly better for patch reviews and Bugzilla is slightly better
for actual bug submissions.

mcl