In this class we will us many tools that are used in professional
software development. In particular, we will make use of the
git
version control software (we will learn
in class how to use it) and we will use GitHub
as a cloud storage service. Each of your homework assignments will be
stored in a repository and autograded on GitHub.
The workflow for submitting homeworks in this class will be
-
Follow the repository creation link (on Canvas). The link looks like
https://classroom.github.com/a/FuNNyleTT3rs
. This will create your personal, private repository, namedhwNN-yourname
where yourname is your GitHub username. -
In the shell on your computer, clone the repository to your own computer, using the specific repository name:
git clone https://github.com/ASU-CompMethodsPhysics-PHY494/hw00-yourname.git
This creates a directory
hw00-yourname
on your computer. This is your local repository. -
Navigate to the local repository
cd hw00-yourname
-
Solve the homework: read the instructions in the assignment file and do what you need to do, e.g., add code, create files and directories, etc.
-
Add your changes (can be done as often as you like):
git add -A .
-
Commit your changes (can be done as often as you like):
git commit -m "update homework"
(You can write any message instead of "update homework".)
-
Push your changes to GitHub (can be done as often as you like):
git push
This will synchronize your repository in the cloud on GitHub with your local repository. When you push the changes, you submit your homework. You can push changes as often as you like until the submission deadline.
Only changes in your GitHub repository until the deadline count for grading.
-
Check autograding: Your homework repository on GitHub has "pull request" named Feedback. Navigate to it in your webbrowser and look at the checks. If you have a green checkmark then all the tests passed. If you have red X then some tests failed and you should look at the output of the tests to see what exactly failed. This will initially look dauting and complicated but you'll quickly learn what to look for.
There is more help available in Viewing autograding results.
-
If you have errors then fix your submission and resubmit:
GOTO 4
-
Else: your done
Let's do hw00 together: follow the instructions above and read assignment_00.md.