From commits-return-1626-apmail-couchdb-commits-archive=couchdb.apache.org@couchdb.apache.org Wed Jan 07 21:08:10 2009 Return-Path: Delivered-To: apmail-couchdb-commits-archive@www.apache.org Received: (qmail 30133 invoked from network); 7 Jan 2009 21:08:10 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 7 Jan 2009 21:08:10 -0000 Received: (qmail 2601 invoked by uid 500); 7 Jan 2009 21:08:09 -0000 Delivered-To: apmail-couchdb-commits-archive@couchdb.apache.org Received: (qmail 2572 invoked by uid 500); 7 Jan 2009 21:08:09 -0000 Mailing-List: contact commits-help@couchdb.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@couchdb.apache.org Delivered-To: mailing list commits@couchdb.apache.org Received: (qmail 2563 invoked by uid 500); 7 Jan 2009 21:08:09 -0000 Delivered-To: apmail-incubator-couchdb-commits@incubator.apache.org Received: (qmail 2560 invoked by uid 99); 7 Jan 2009 21:08:09 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 07 Jan 2009 13:08:09 -0800 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.130] (HELO eos.apache.org) (140.211.11.130) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 07 Jan 2009 21:08:00 +0000 Received: from eos.apache.org (localhost [127.0.0.1]) by eos.apache.org (Postfix) with ESMTP id AEE4B118D7 for ; Wed, 7 Jan 2009 21:07:40 +0000 (GMT) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: Apache Wiki To: couchdb-commits@incubator.apache.org Date: Wed, 07 Jan 2009 21:07:40 -0000 Message-ID: <20090107210740.26825.7842@eos.apache.org> Subject: [Couchdb Wiki] Update of "How to contribute (for Non-Committers)" by LukeVenediger X-Virus-Checked: Checked by ClamAV on apache.org Dear Wiki user, You have subscribed to a wiki page or wiki category on "Couchdb Wiki" for change notification. The following page has been changed by LukeVenediger: http://wiki.apache.org/couchdb/How_to_contribute_%28for_Non-Committers%29 The comment on the change is: Adding a page describing how to submit a patch to Couchdb New page: Thanks for your interest in growing Couchdb! This page will explain the process of submitting code to fix issues or add features. In this document: * [#pre Prerequisites] * [#step1 Step 1: See if your bug/feature exists in JIRA] * [#step2 Step 2: Go forth and code!] * [#step3 Step 3: Create and Upload a Patch] * [#questions Asking Questions And Getting Feedback] [[Anchor(pre)]] == Prerequisites == Ensure that you've * Installed from source: ["Installing from source"] * Got your system running in Dev mode: ["Running Couchdb in Dev Mode"] [[Anchor(step1)]] == Step 1: See if your bug/feature exists in JIRA == * JIRA is the issue tracker that Couchdb uses to track items of work. * Visit https://issues.apache.org/jira/browse/COUCHDB to see if your issue already exists. * If it doesn't, you can open one by * Registering for a JIRA account here: https://issues.apache.org/jira/secure/Signup!default.jspa * Then opening a new issue here: https://issues.apache.org/jira/secure/CreateIssue!default.jspa * Either way, bookmark the link because you'll need it to comment or submit patches. '''Note:''' You're still welcome to submit patches even if an issue has been assigned to someone else. In this case, it's probably better to add a comment before getting started. [[Anchor(step2)]] == Step 2: Go forth and code! == * Before starting, make sure that your local copy is up to the latest version * For those using the command-line subversion tools, run this before starting: {{{ $ cd YOUR-COUCHDB-CHECKOUT-DIR $ svn update }}} * Don't forget to rebuild couchdb afterwards {{{ $ cd YOUR-COUCHDB-CHECKOUT-DIR $ make dev }}} [[Anchor(step3)]] == Step 3: Create and Upload a Patch == * Once you've completed the feature/fix you will need to create a patch * From the command line, call the following, giving your patch a name: {{{ $ cd YOUR-COUCHDB-CHECKOUT-DIR $ svn diff > your_patch_file_name.diff }}} * Open up the issue link you found/created in Step 1 * Click on '''Attach File''' under the '''Operations''' menu on the left * Add your file and add a comment about the change. And you're done! [[Anchor(questions)]] == Asking Questions And Getting Feedback == You can contact the couchdb developers to ask questions and propose ideas by: * Sending a mail to the Dev mailing list: http://wiki.apache.org/couchdb/Mailing_lists or, * Chatting on IRC: #couchdb on Freenode (irc.freenode.net) All issues created in JIRA are mailed to the Dev mailing list.