Project -1

Jan 11, 2012

Objective

Get your development workstation and the software suite ready to go, and clone a remote source code repository to keep track of your work.

Requirements

Create an account on github if you don't have one.

After you have created your account, send me an email by midnight, Wednesday Jan. 11 that contains your github username. I should be able to visit http://github.com/YOURUSERNAME and see your github profile.

You will receive an email response containing the url for your remote git repository. While you wait for a response from me, you will need to create an ssh key (instructions: windows | everyone else). Be sure to add your public key to your github profile per those instructions. (windows users, beware when copying from notepad. See this screenshot.)

Create a dedicated working directory for our projects called cs410. Where you put this directory is up to you (eg, "My Documents" or ~).

Download and install the ECS software suite inside your cs410 directory.

Create a subdirectory of cs410 called src. This is your dedicated working directory for our projects.

At this point your directory structure should look like this:

[DIR_OF_YOUR_CHOICE]/
  cs410/
    src/
    tecs-software-suite-2.5/

Install git on your workstation.

Next, configure git so that it can add your full name to the commit log:

git config --global user.name "Tiger Woods"
git config --global user.email "performancedeliveredindeed@accenture.com"

Now create your repository:

cd cs410/src
git init
touch README
git add README
git commit -m 'first commit'

You should now have a repository in src. Edit the README file (add your full name and a one line description of what this repository is). Add your change and commit it.

git add README
git commit -m "Adding initial README file."

Now your change is committed... but you need to push your changes to the remote repository so I can see it.

git remote add origin git@github.com:ybakos/YOUR_REPOSITORY.git
git push -u origin master

If successful, you should see something like the following on your screen:

Counting objects: 5, done.
Delta compression using 2 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 6.28 KiB, done.
Total 15 (delta 1), reused 0 (delta 0)
To git@github.com:ybakos/cs410.git
2e22aea..7fbdad6 master -> master

You should also be able to visit http://github.com/ybakos/YOUR_REPOSITORY and see your repository there. NOTE: You might not, depending on how heavily loaded github is. As long as you see the above output on your console, your changes were pushed correctly.

Optional: If you are unfamiliar with git, spend some time reading this stuff.

Grading Criteria (50 pts)

I must receive a message via github containing your github username by midnight Wednesday, Jan 11.

Your cs410 directory structure must match the example given (you can rename tecs-software-suite-2.5 to tools if you wish).

I must be able to visit http://github.com/ybakos/YOUR_REPOSITORY and see that you have pushed your README file (your repository Web page should look something like this) and therefore be able to clone your repository by midnight on Friday, January 13.

This is due by midnight on Friday, January 13.