From owner-freebsd-doc@FreeBSD.ORG Fri Apr 5 05:13:31 2013 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 5683A762; Fri, 5 Apr 2013 05:13:31 +0000 (UTC) (envelope-from yaneurabeya@gmail.com) Received: from mail-pa0-f43.google.com (mail-pa0-f43.google.com [209.85.220.43]) by mx1.freebsd.org (Postfix) with ESMTP id 2F9C7106; Fri, 5 Apr 2013 05:13:31 +0000 (UTC) Received: by mail-pa0-f43.google.com with SMTP id hz11so1876073pad.30 for ; Thu, 04 Apr 2013 22:13:25 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:subject:mime-version:content-type:from:in-reply-to:date :cc:content-transfer-encoding:message-id:references:to:x-mailer; bh=cMOobN4c+f1/R+tQKs3ZI6ZcoKaCmx57myCtVoXLbjs=; b=JBnbUJytBKEQloFdyERbUYWzrXgL/puB35s3lFlzplgVF2dNz9zd0sUOYJqdz2zF4j 6k0BJ0z14xXw5dVRhXVzPdyjUhIpnhxhjaCEWwo+pBf8NYwLv16VQzFuoun7BDV96SZV Kj56+59zs0R1LBADuiM8HKXIdh+u//jY0I8yqjqyu3ENZorFNn+g0t+AmsLn4j35QXwE aPY4ah2MKqXksLqy5ywHwSAamlcMecNAiE5PNk+3elJuDh7mnqiUCUMohvZIgNP1Q3U8 afKtKwKpq6uYymu/Uvxbr0APSHXTSaYaNwjdNcYzm9GQzjNx9/wEdmu/1QZseJjfcUwd boRg== X-Received: by 10.68.212.233 with SMTP id nn9mr12473374pbc.144.1365138805754; Thu, 04 Apr 2013 22:13:25 -0700 (PDT) Received: from [192.168.20.11] (c-24-19-191-56.hsd1.wa.comcast.net. [24.19.191.56]) by mx.google.com with ESMTPS id qd8sm12901664pbc.29.2013.04.04.22.13.24 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 04 Apr 2013 22:13:25 -0700 (PDT) Subject: Re: Need help documenting development processes in FreeBSD Mime-Version: 1.0 (Apple Message framework v1283) Content-Type: text/plain; charset=us-ascii From: Garrett Cooper In-Reply-To: <20130404182550.GA2002@devbox.vnode.local> Date: Thu, 4 Apr 2013 22:13:22 -0700 Content-Transfer-Encoding: quoted-printable Message-Id: <82B166A6-EC29-490E-89A5-5646FD6227E2@gmail.com> References: <20130404182550.GA2002@devbox.vnode.local> To: Joel Dahl X-Mailer: Apple Mail (2.1283) Cc: core@FreeBSD.org, doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 05 Apr 2013 05:13:31 -0000 (picking a "random" reply) On Apr 4, 2013, at 11:25 AM, Joel Dahl wrote: > On Mon, Apr 01, 2013 at 05:57:20PM -0700, Garrett Cooper wrote: >> Hi, >> In order to bring contributors up to speed on how to interact with >> FreeBSD, I want to document some of the items that aren't really = noted in >> the FreeBSD developers or committers handbook. Some topics that come = to >> mind are "How do I do a precommit build?" (tinderbox, etc), "How do I = test >> my changes?" (there's a chapter, but it's not helpful), "How do I get >> involved with the project?", "How do I build quickly?", "What are = mtree >> files?", etc. >> I was wondering if a) there are any other developers interested in = this >> effort, b) where it should go (in the dev handbook?), and c) who = would be >> interested in reviewing the work? I'd like to put it up on the wiki = first >> (as I'm not an SGML wizard) and put it in SGML eventually, but I need >> feedback on whether or not this is doable. >> Thanks! >=20 > Cool. This is something I've wanted to do ever since I joined the = project. > Just start with the wiki and don't think too much about markup - we = can worry > about that and where to place it later. Thanks for the input/support everyone! Once I get access to the = wiki again (minor auth problems right now after I asked postmaster to = deactivate my FreeBSD.org mailing alias >_>...), I'll start drafting = chapters on how to work better with FreeBSD. I already have a chapter in = the works with building FreeBSD from scratch that I've gotten positive = feedback on from internal users that I might incorporate in a chapter. Thanks! -Garrett=