cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Cordova Wiki] Update of "ContributorWorkflow" by MarcelKinard
Date Thu, 07 Feb 2013 20:22:48 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Cordova Wiki" for change notification.

The "ContributorWorkflow" page has been changed by MarcelKinard:
http://wiki.apache.org/cordova/ContributorWorkflow?action=diff&rev1=16&rev2=17

Comment:
expanded instructions for contributors regarding github

  
  = Fork =
  
- Fork the official Apache Cordova project mirror with git, the chosen revision control system
for the Cordova project. There are many places to clone the code from:
+ Fork the official Apache Cordova project mirror with git. Git is the chosen revision control
system for the Cordova project. There are many places to clone the code from:
  
   * from the [[http://git-wip-us.apache.org/repos/asf|official Apache servers]]
-  * on [[http://github.com/apache|GitHub]]
+  * on [[http://github.com/apache|GitHub]] (type "cordova" into the "Find a Repository" box)
  
- For example, to fork the cordova documentation repository, from your shell you would run:
+ Committers will typically fork from the official Apache server, since they are authorized
to commit directly back to it. This is the authoritative / official repo.
  
- {{{
+ However, contributors should typically fork from !GitHub. This makes it easy to submit pull
requests, which is the preferred method to make contributions as a non-committer. So as a
contributor you should:
+ 
+  1. Create an account on github.com
+  1. On the !GitHub web interface, fork github.com/apache/cordova-x.git to your own account
on !GitHub (ie, github.com/you/cordova-x.git)
+  1. From your workstation, clone your !GitHub repo (ie, github.com/you/cordova-x.git) to
your workstation. For example, to clone a Cordova repository, from your workstation shell
you would run (note the "https" protocol):
+  {{{ $ git clone https://github.com/you/cordova-x.git }}}
+  1. Add a pointer back to the official repo:
- $ git clone https://git-wip-us.apache.org/repos/asf/cordova-docs.git
+  {{{ $ git remote add cordova https://git-wip-us.apache.org/repos/asf/cordova-x.git }}}
- }}}
  
  Here is a [[http://cordova.apache.org/wiki-images/contributor-git.png|diagram of the repos
and their flows]].
+ 
+ In the examples here, replace "cordova-x.git" with the actual repository name, such as "cordova-docs.git",
and replace "you" in "github.com/you" with your !GitHub userid.
+ 
+ If you want to simply check out the source code and don't plan on making contributions,
then you can skip !GitHub and clone directly from the Apache servers:
+ {{{ $ git clone https://git-wip-us.apache.org/repos/asf/cordova-x.git }}}
  
  = Working in git =
  

Mime
View raw message