From owner-freebsd-doc@FreeBSD.ORG Thu Aug 21 09:59:06 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9B55D1065686 for ; Thu, 21 Aug 2008 09:59:06 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: from wr-out-0506.google.com (wr-out-0506.google.com [64.233.184.229]) by mx1.freebsd.org (Postfix) with ESMTP id 503008FC2E for ; Thu, 21 Aug 2008 09:59:06 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: by wr-out-0506.google.com with SMTP id c8so395501wra.27 for ; Thu, 21 Aug 2008 02:59:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :organization:user-agent:mime-version:to:subject:x-enigmail-version :content-type:content-transfer-encoding:sender; bh=oxo+NHuQ9x/Mh8MT04MC9YyJh8k2Xg02A86pna3ByZI=; b=OAi/tZIVBxdLdxjdYgW288fonUYGzUyniAW8xq8e0jZ8t6PsrGJW/u+M5jJdz5KffI 3fEruksIaqJv0jTZnMM6o3jZZzttS/7TFwovxggfa0WGozgiGysjSgTyBPm6aRTPKGnq Y6H2Bg/ddTU7PstbZ6WWm+Y1knrGxAHEzXIVM= DomainKey-Signature: a=rsa-sha1; c=nofws; d=googlemail.com; s=gamma; h=message-id:date:from:organization:user-agent:mime-version:to :subject:x-enigmail-version:content-type:content-transfer-encoding :sender; b=q4ZOzxTqk7kYbl+FfpxHxQasgydRmIFmPpsUL2BRcG1VABfk7L23JitST5iJSfI3zY nN1fJeymfe74Atk/Ux40xPwJnWt3btW4mbM+zDPGEu3Gq11ku9VA2a7wdb48LuavOXS6 TFwhdGYqVX+o5QcE4LzaREbeoqA/6kpkHBCUg= Received: by 10.90.93.8 with SMTP id q8mr1587021agb.116.1219312745125; Thu, 21 Aug 2008 02:59:05 -0700 (PDT) Received: from ?192.168.0.1? ( [80.99.205.120]) by mx.google.com with ESMTPS id w43sm2068068hsa.15.2008.08.21.02.59.03 (version=TLSv1/SSLv3 cipher=RC4-MD5); Thu, 21 Aug 2008 02:59:04 -0700 (PDT) Message-ID: <48AD3C61.50605@FreeBSD.org> Date: Thu, 21 Aug 2008 11:58:57 +0200 From: Gabor PALI Organization: The FreeBSD Project User-Agent: Thunderbird 2.0.0.14 (X11/20080521) MIME-Version: 1.0 To: freebsd-doc@freebsd.org X-Enigmail-Version: 0.95.1 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Sender: =?UTF-8?B?UMOBTEkgR8OhYm9yIErDoW5vcw==?= Subject: Request for Comments: Update to developers-handbook/policies X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 21 Aug 2008 09:59:06 -0000 Dear Members, A few weeks ago, I started to work on docs/126030 [1] in cooperation with Gavin Atkinson and Giorgos Keramidas to update chapter ``Source Tree Guidelines and Policies'' of the ``FreeBSD Developers' Handbook'' [2]. Based on Gavin's original patch, I created drafts on how to fix the sections in question (and I linked them below). During the update, I found useful to include a section of Dag-Erling's Subversion Primer on the Wiki [3] about vendor imports. At the moment, I do not erase the old text (about vendor imports with CVS) but I kept it for compatibility reasons (and moved to a separate subsection as des@ advised). However, if somebody says it is deemed to be removed I will do that. Because I am not so experienced in vendor imports (as a doc committer) but I would like to help Gavin (and others who want this book updated), I ask you to review my changes and express your ideas, comments and suggestion. Draft of section (5.1) MAINTAINER on Makefiles: http://people.freebsd.org/~pgj/for_review/2008-08-21/html/policies.html Draft of section (5.2) Contributed Software: http://people.freebsd.org/~pgj/for_review/2008-08-21/html/policies-contributed.html Diff for the curious: http://people.freebsd.org/~pgj/for_review/2008-08-21/books.developers-handbook.policies.diff Thank you in advance. Cheers, :g [1] http://www.freebsd.org/cgi/query-pr.cgi?pr=docs%2F126030 [2] http://www.freebsd.org/doc/en/books/developers-handbook [3] http://wiki.freebsd.org/SubversionPrimer/VendorImports