Return-Path: X-Original-To: apmail-gearpump-dev-archive@minotaur.apache.org Delivered-To: apmail-gearpump-dev-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 1096D1949A for ; Sat, 16 Apr 2016 17:31:47 +0000 (UTC) Received: (qmail 75752 invoked by uid 500); 16 Apr 2016 17:31:47 -0000 Delivered-To: apmail-gearpump-dev-archive@gearpump.apache.org Received: (qmail 75718 invoked by uid 500); 16 Apr 2016 17:31:47 -0000 Mailing-List: contact dev-help@gearpump.incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@gearpump.incubator.apache.org Delivered-To: mailing list dev@gearpump.incubator.apache.org Delivered-To: moderator for dev@gearpump.incubator.apache.org Received: (qmail 1785 invoked by uid 99); 16 Apr 2016 07:59:03 -0000 X-Virus-Scanned: Debian amavisd-new at spamd1-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: -5.016 X-Spam-Level: X-Spam-Status: No, score=-5.016 tagged_above=-999 required=6.31 tests=[KAM_LAZY_DOMAIN_SECURITY=1, RCVD_IN_DNSWL_HI=-5, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, RP_MATCHES_RCVD=-0.996] autolearn=disabled From: manuzhang To: dev@gearpump.incubator.apache.org Reply-To: dev@gearpump.incubator.apache.org References: In-Reply-To: Subject: [GitHub] incubator-gearpump pull request: gearpump-34 update developer docu... Content-Type: text/plain Message-Id: <20160416075858.9B172DFC6F@git1-us-west.apache.org> Date: Sat, 16 Apr 2016 07:58:58 +0000 (UTC) Github user manuzhang commented on a diff in the pull request: https://github.com/apache/incubator-gearpump/pull/1#discussion_r59964265 --- Diff: CONTRIBUTING.md --- @@ -1,41 +1,125 @@ -This documents are for committers which have direct write permission to intel-hadoop/gearpump +# Developer documentation -Commit Guideline -======================== -1. For all commit(except doc), must create an issue id. -2. For all commit log message, must contain the issue id, Like this: fix #issueId, comments. -3. For all PR, the title must contains issue Id. -4. We use rebase and squash instead of merge to ensure the log message is clean. Check section "Pull Request merge process for Gearpump" -5. Every commit (except doc) must have 1 guy to review before commit. +This document summarizes the information relevant to Gearpump committers and contributors. It includes information about +the development processes and policies as well as the tools we use to facilitate those. -Pull Request merge process for Gearpump -======================== -1. Fork in github to create a /gearpump repo. After fork, you will have a new repo at http://github.com//gearpump. -2. Add gearpump/gearpump as an external repo 'upstream' by following the [guide](https://help.github.com/articles/configuring-a-remote-for-a-fork/). +--- - ```bash - git remote add upstream https://github.com/gearpump/gearpump.git - ``` +Table of Contents +* Welcome! +* Contribution workflow + * Report a bug + * Request a new feature + * Contribute code/document by creating a Pull Request + * Code Review +* Build the code and run the tests + * Make a local copy of Gearpump + * How to build + * How to test + * How to build document + * IDE setup + * Code style + * How to write unit test + * How to write integration test + * How to write document +* Committer section + * Approve a pull request + * Merge a pull request or patch + * How to make a release -3. In local master branch, periodically sync the forked master with the main master with - - ``` - git pull --rebase upstream master - git push origin master - ``` -No work should ever be done in the forked master. Another way to do this is to +--- - ``` - git checkout master - git fetch upstream - git rebase upstream/master - ``` + + +# Welcome! + +If you are reading this document then you are interested in contributing to the Gearpump project -- many thanks for that! +All contributions are welcome: ideas, documentation, code, patches, bug reports, feature requests, etc. + + + +# Contribution workflow + +This section explains how to make a contribution. + + + + +## Report a bug + +To report a bug you should [open an issue](https://issues.apache.org/jira/browse/GEARPUMP) in our issue tracker that +summarizes the bug. Set the form field "Issue type" to "Bug". If you have not used the issue tracker before you will +need to register an account (free), log in, and then click on the blue "Create Issue" button in the top navigation bar. --- End diff -- red "Create Issue" button ? --- If your project is set up for it, you can reply to this email and have your reply appear on GitHub as well. If your project does not have this feature enabled and wishes so, or if the feature is enabled but not working, please contact infrastructure at infrastructure@apache.org or file a JIRA ticket with INFRA. ---