From owner-freebsd-doc@FreeBSD.ORG Tue Apr 2 00:57:20 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 9C02C9C8; Tue, 2 Apr 2013 00:57:20 +0000 (UTC) (envelope-from yaneurabeya@gmail.com) Received: from mail-ie0-x22c.google.com (mail-ie0-x22c.google.com [IPv6:2607:f8b0:4001:c03::22c]) by mx1.freebsd.org (Postfix) with ESMTP id 6C9A3A76; Tue, 2 Apr 2013 00:57:20 +0000 (UTC) Received: by mail-ie0-f172.google.com with SMTP id c10so2914608ieb.17 for ; Mon, 01 Apr 2013 17:57:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:x-received:date:message-id:subject:from:to:cc :content-type; bh=vr33kMtBR5hyUcEtxtH+c1Ou7xXzhkg50oR2S0o8dnQ=; b=ns3ELCFbW07/MvR6CNoznpjf+DhD4RcMz+mv5EemReXxT1figiEKzPk67ofcgIlnad z7EmgS8ou6I9LWDy5wFQCfxPhdQr2RU7Oo03fkiXCESxxoYHInZQCYuOh+I/xZCJ0ToV F2yhvEDDoGz9RRxx9Zi5Qk7n3lS8Gjd3toFWuHSTf1pCYxySlWoyP2CHrW3EytBgKJtQ m47PtATfpmeMJVYvUzJVhgvfcXTx2EGibC5E9wbd3gnJE5hopArjJnEf+uqTswfZtfh/ ZvYe8odI5uailoMm3oHbjlQ5hUsPv7QeA6Pzlg2zV/KGvrTCZQQpt/e7+V9uRwq1/toA G2XQ== MIME-Version: 1.0 X-Received: by 10.42.155.136 with SMTP id u8mr5860963icw.26.1364864240117; Mon, 01 Apr 2013 17:57:20 -0700 (PDT) Received: by 10.64.30.99 with HTTP; Mon, 1 Apr 2013 17:57:20 -0700 (PDT) Date: Mon, 1 Apr 2013 17:57:20 -0700 Message-ID: Subject: Need help documenting development processes in FreeBSD From: Garrett Cooper To: doc@FreeBSD.org Content-Type: text/plain; charset=ISO-8859-1 X-Content-Filtered-By: Mailman/MimeDel 2.1.14 Cc: core@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: Tue, 02 Apr 2013 00:57:20 -0000 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! -Garrett