There are three GitHub repositories:
- kbalog/web-programming: (i.e., this repository) contains examples, exercises, assignment descriptions, etc. (public)
- uis-dat310-spring2018/{yourname}-assignments: your submissions for the assignments ({yourname} is to be substituted with the username you registered on GitHub) (private)
- uis-dat310-spring2018/assignments-2018: contains the reference solutions to the assignments (posted after the deadline has passed) (private)
Private means that you need to sign up on the Online Course Admin to get access to these repositories. (Note that the private repositories are created manually, in batches, so you might need to wait 1-2 days after you signed up.)
You can clone this repository if you want a local copy of the examples and exercises used during the lectures. It is advised that you treat this local copy read-only, that is, you can add new files, but you should not edit any of the existing files to avoid conflicting changes.
Alternatively, you can always just open the exercise files on GitHub and copy-paste their contents into new files on your local computer.
This is your private repository; no one will (or can) make changes here but you. Clone this repository on your computer, add/edit the files in the folder corresponding to the given assignment, then commit and push ("sync") the changes. You can make sure that your changes have been submitted by checking the contents on the web interface: https://github.com/uis-dat310-spring2018/{username}-assignments
- If the link does not work, then you might have to accept the GitHub invitation first (this is to be done only once). Go to https://github.com/uis-dat310-spring2018, where you should see an Accept button. Then, you will be able to access your repository.
You will only need this repository when you want to study the reference solutions once they are published. You can clone the repository to have a local copy. You don't have permissions to make changes.
You can use a graphical client. I recommend the official GitHub client (GitHub Desktop), which is available for both Windows and Mac: https://desktop.github.com/.
You can also work from the command line (for geeks). Here is a crash course: http://try.github.io.
- Clone repository (to be done only once)
- Pull changes from server (
pull) - Make local changes (edit/add/delete files)
- Commit changes to server (
commit) - Push changes to server (
push)
In GitHub desktop, both pull and push are called "sync".
(Illustrated using GitHub Desktop.)
The first two steps are to be done only once.
Download it from: https://desktop.github.com/
- Go to your private repository: https://github.com/uis-dat310-spring2018/{yourname}-assignments
- Click the clone in Desktop button.
- Specify the target folder, then you’ll see something like this:
- Click the Sync button to receive the starter files (if you cloned the repository for the first time, then you won't see anything new).
- Complete the assignment — add/edit files in the given assignment folder (e.g., 1).
- When you're done, you should see a number of uncommitted changes.
- Click the button X Uncommitted Changes to switch to the list of changes.
- Make sure all your changes are selected.
- (A) Fill in the Summary (doesn't matter what you put there); the Description can be left empty.
- (B) Click Commit to master.
- (C) Press Sync.
That's it. You can double check on the web interface if your changes have been synchronized.
Note that you can submit any number of times; feel free to use this repository as your back-up. Your submission will be evaluated (i.e., looked at) only after the submission deadline.