From owner-freebsd-doc@freebsd.org Wed Mar 1 20:35:52 2017 Return-Path: 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 BE299CF39C6 for ; Wed, 1 Mar 2017 20:35:52 +0000 (UTC) (envelope-from wblock@wonkity.com) 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 8E520403 for ; Wed, 1 Mar 2017 20:35:52 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.15.2/8.15.2) with ESMTPS id v21KZlOi007525 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Wed, 1 Mar 2017 13:35:47 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.15.2/8.15.2/Submit) with ESMTP id v21KZlYh007522; Wed, 1 Mar 2017 13:35:47 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Wed, 1 Mar 2017 13:35:47 -0700 (MST) From: Warren Block To: Peter Looyenga cc: freebsd-doc@freebsd.org Subject: Re: Introduction & question / comment regarding source tree documentation In-Reply-To: <000001d2923c$117af6d0$3470e470$@catslair.org> Message-ID: References: <000001d2923c$117af6d0$3470e470$@catslair.org> User-Agent: Alpine 2.20 (BSF 67 2015-01-07) MIME-Version: 1.0 Content-Type: text/plain; format=flowed; charset=US-ASCII X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.6.2 (wonkity.com [127.0.0.1]); Wed, 01 Mar 2017 13:35:47 -0700 (MST) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 01 Mar 2017 20:35:52 -0000 On Wed, 1 Mar 2017, Peter Looyenga wrote: > My current drive: I can't help feel that the steps required to obtain the > source tree aren't very well explained, and as a result several people and > up confused. To put it more blunt, this thread is what drove me to try and > take more action: > > https://forums.freebsd.org/threads/59919/ > My only concern (and actual question): Is this already work in progress by > any chance? I don't mind spending a good amount of time on writing up some > documentation, but I have a little bit of a problem with setting something > up only to find out that it wasn't needed at all. It is needed. I have some work already on this related part: https://reviews.freebsd.org/D7665 > Note: I don't mind if I send in suggestions and then see them not getting > accepted, that's all part of the game. But it would be bad for me when I > start working on this, only to discover that someone else was already > working on it so I basically ended up wasting my time. > > Hope you guys can give me some pointers on this. Please see the FDP Primer for general guides: https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/index.html