From owner-freebsd-doc@freebsd.org  Fri Sep  4 18:00:22 2015
Return-Path: <owner-freebsd-doc@freebsd.org>
Delivered-To: freebsd-doc@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id 2B45C9CBEF4
 for <freebsd-doc@mailman.ysv.freebsd.org>;
 Fri,  4 Sep 2015 18:00:22 +0000 (UTC)
 (envelope-from freebsd-lists@be-well.ilk.org)
Received: from be-well.ilk.org (be-well.ilk.org [23.30.133.173])
 by mx1.freebsd.org (Postfix) with ESMTP id 0A8DF65C
 for <freebsd-doc@freebsd.org>; Fri,  4 Sep 2015 18:00:22 +0000 (UTC)
 (envelope-from freebsd-lists@be-well.ilk.org)
Received: by be-well.ilk.org (Postfix, from userid 1147)
 id D5DE233C46; Fri,  4 Sep 2015 14:00:14 -0400 (EDT)
From: Lowell Gilbert <freebsd-lists@be-well.ilk.org>
To: Jeremy Gransden <jeremy.gransden@gmail.com>
Cc: freebsd-doc@freebsd.org
Subject: Re: Making changes to files from the handbook.
References: <CALi7Q_rg1KQAZCUwC09DFLaiN-P2+KKwsac7hPgqi_6jk3tf+A@mail.gmail.com>
Date: Fri, 04 Sep 2015 14:00:14 -0400
In-Reply-To: <CALi7Q_rg1KQAZCUwC09DFLaiN-P2+KKwsac7hPgqi_6jk3tf+A@mail.gmail.com>
 (Jeremy Gransden's message of "Fri, 4 Sep 2015 13:45:33 -0400")
Message-ID: <44a8t2kqtt.fsf@be-well.ilk.org>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.5 (berkeley-unix)
MIME-Version: 1.0
Content-Type: text/plain
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.20
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: Fri, 04 Sep 2015 18:00:22 -0000

Jeremy Gransden <jeremy.gransden@gmail.com> writes:

> Since the handbook, FAQ, and other docs come in a variety of formats; what
> files are the correct ones to create a pr and diff from when changes are
> made?

The formats you see are all outputs.
Like for programming, you want to change the source code.

See the FreeBSD Documentation Project Primer for New Contributors:
 	https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/

In particular, your question is covered in:
 	https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/working-copy-checking-out.html