From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 15:15:09 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 169D516A4CF for ; Thu, 15 Jul 2004 15:15:09 +0000 (GMT) Received: from internet.potentialtech.com (h-66-167-251-6.phlapafg.covad.net [66.167.251.6]) by mx1.FreeBSD.org (Postfix) with ESMTP id E530843D46 for ; Thu, 15 Jul 2004 15:15:08 +0000 (GMT) (envelope-from wmoran@potentialtech.com) Received: from working.potentialtech.com (pa-plum-cmts1e-68-68-113-64.pittpa.adelphia.net [68.68.113.64]) by internet.potentialtech.com (Postfix) with ESMTP id F027269A39; Thu, 15 Jul 2004 11:15:07 -0400 (EDT) Date: Thu, 15 Jul 2004 11:15:06 -0400 From: Bill Moran To: "Steve Bertrand" Message-Id: <20040715111506.157a7b26.wmoran@potentialtech.com> In-Reply-To: <1223.209.167.16.15.1089901719.squirrel@209.167.16.15> References: <1223.209.167.16.15.1089901719.squirrel@209.167.16.15> Organization: Potential Technologies X-Mailer: Sylpheed version 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd4.9) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: freebsd-doc@freebsd.org Subject: Re: Submitting patches X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 15 Jul 2004 15:15:09 -0000 "Steve Bertrand" wrote: > I've been tracking some doc pr's, and am a little confused as to how to > submit patches. > > I am just following the handbook for now, as I have no idea how to write > manual pages, but don't exactly understand proper procedure for actually > making a contribution. > > In the pr list, can I just find something I'd like to fix, then send the > patch to the list, or do I submit it through send-pr? If you look at the web page showing PRs, there's a "reply to this PR" like at the bottom. This is the best way to respond, as it records your response in the PR database and emails anyone listed as responsible. > If someone else has already taken responsibility for a pr, is it deemed > offensive if I submit my own patch even if the pr is still 'open'? Not offensive, but I would definately email the person responsible to make sure you're not duplicating effort. It's possible that the person responsible is "mostly done" with a fix. > I'm very excited about making an initial contribution, however, I want to > ensure I follow proper order as to not offend anyone, and make it as easy > as possible for everyone. If it seems you've offended anyone, don't take it personally. Keep in mind that most people work on FreeBSD because they enjoy it and/or they believe in it. This means when things don't go as planned or expected, folks can get pretty emotional. It's just a side effect of being involved in a project where people _really_ care about what they're doing (and don't just write it off as "well, I get paid anyway") I think that's something that often scares a lot of people away from OSS projects. -- Bill Moran Potential Technologies http://www.potentialtech.com