From owner-freebsd-doc@FreeBSD.ORG  Sun Jul  6 19:46:52 2014
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 9C7A8704;
 Sun,  6 Jul 2014 19:46:52 +0000 (UTC)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "wonkity.com", Issuer "wonkity.com" (not verified))
 by mx1.freebsd.org (Postfix) with ESMTPS id 4546D2F09;
 Sun,  6 Jul 2014 19:46:52 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.9/8.14.9) with ESMTP id s66Jkop6035614
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO);
 Sun, 6 Jul 2014 13:46:50 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.9/8.14.9/Submit) with ESMTP id s66JkoZL035611;
 Sun, 6 Jul 2014 13:46:50 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Sun, 6 Jul 2014 13:46:50 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Adrian Chadd <adrian@freebsd.org>
Subject: Re: looking for help to document the new RSS stuff
In-Reply-To: <CAJ-Vmong1+TGcUbPT-g-YJ2bxzkdJ74weD1112R=PdEhQD14ig@mail.gmail.com>
Message-ID: <alpine.BSF.2.11.1407061343270.22171@wonkity.com>
References: <CAJ-Vmong1+TGcUbPT-g-YJ2bxzkdJ74weD1112R=PdEhQD14ig@mail.gmail.com>
User-Agent: Alpine 2.11 (BSF 23 2013-08-11)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Sun, 06 Jul 2014 13:46:51 -0600 (MDT)
Cc: doc@freebsd.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://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: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 06 Jul 2014 19:46:52 -0000

On Sun, 6 Jul 2014, Adrian Chadd wrote:

> I'm looking for some help to document the new RSS stuff.
>
> I'm happy writing up some text documentation - shall I just email out
> the bits here so I can get some help with markup and such?

Is this for a man page or book or article?

Mailing list threads can make it hard to track suggestions.  Posting a 
diff to phabricator can actually be better, with all the suggestions in 
one place.  Or maybe one doc person can help with an initial version 
first, and then put it on phabricator for review.

But first, let's find out which kind of document.