Changes

== Gitorious ==

== Gitorious ==

Getting started with Gitorious, a web based Git service provided by Sugar Labs.

Getting started with GitHub

You will learn to do the following:

You will learn to do the following:

=== Create an Account ===

=== Create an Account ===

Create an account on git.sugarlabs.org by selecting the ''Register'' link on the page.  You will be asked:

Create an account [https://github.com/join here]

 

 

Once you do this, Gitorious knows who you are and how to contact you.  You should only need to do this once.

 

=== Create SSH Key on Windows ===

=== Create SSH Key on Windows ===

=== Add SSH Key ===

=== Add SSH Key ===

Log in to Gitorious at http://git.sugarlabs.org/ click on ''Dashboard'', then ''Manage SSH'', then ''Add SSH key''. The ''Add a new public SSH key'' page will appear, with a large text entry field. Open your public key in a text editor, web browser, or even ''cat'' command, and then copy and paste the key into the text entry field.  Click on ''Save''.

Log in to GitHub at http://github.com and go [https://github.com/settings/ssh here] click on 'Add Ssh Key'. Choose a title. Open your public key in a text editor, web browser, or even ''cat'' command, and then copy and paste the key into the text entry field.  Click on ''Save''.

Once you do this, Gitorious trusts SSH connection from your system because your system has the private key, and Gitorious has the public key.  You should only need to do this once, unless you change to another system.

Once you do this, Gitorious trusts SSH connection from your system because your system has the private key, and Gitorious has the public key.  You should only need to do this once, unless you change to another system.

(With ssh-keygen you can specify the name of your key file. Using this feature is not a good idea, because we haven't tested it. Keys should generally be located in <tt>~/.ssh/id_rsa.pub</tt> or <tt>~/.ssh/id_dsa.pub</tt>.)

(With ssh-keygen you can specify the name of your key file. Using this feature is not a good idea, because we haven't tested it. Keys should generally be located in <tt>~/.ssh/id_rsa.pub</tt> or <tt>~/.ssh/id_dsa.pub</tt>.)

=== Create a Project ===  

=== Create a Project ===  

Log in to Gitorious at http://git.sugarlabs.org/ and check that the activity is not already listed.  If it is listed, note the clone URL and skip to the next section.  If it is not listed, then click the ''Create a new project'' link on the ''Projects'' page, and enter:

Log in to Gitorious at http://github.com and go [https://github.com/new here]. Choose a repository name, and write a description.

then click on ''Create project''. There several other question which can be answered later as you have more information.

 

 

Click on ''Add a repository'' and select a name of ''mainline''.

 

Once this step is done, Gitorious will have created a git repository at Sugar Labs.  You must only do this once for each project.

=== Create Local Repository ===

=== Create Local Repository ===

Clone it from Gitorious:

Clone it from Gitorious:

  git clone gitorious@git.sugarlabs.org:${SLUG}/mainline.git ${SLUG}.git

  git clone git@github.com:username/${SLUG}.git ${SLUG}.git

Replace ''${SLUG}'' with your project slug value.

Replace ''${SLUG}'' with your project slug value.