This is the main repository for homework problems and solutions.
If you have questions, comments, or suggestions, please open a New Issue.
If you are new to Git, please try the 15 Git minute tutorial. Also, the git--the simple guide and the GitHub help pages are excellent.
-
First, you should tell me your GitHub username so I can add you as a collaborator on the Math700Homework project.
(Actually, this isn't absolutely necessary, and you could still contribute using forks and pull requests if you weren't a collaborator, but since the class is small, I think it will be easier if all students taking the class for credit are collaborators.)
-
Next, you should install Git on your computer.
-
Once I add you as a collaborator, you should clone the Math700Homework repository to your computer's hard drive. How you do this may depend on your operating system. In Linux I invoke the following at the command line
cd ~/git git clone [email protected]:williamdemeo/Math700Homework.git
-
Make some changes to the files in the repository. For example, you might edit the file called Homework01.tex.
-
Commit your changes to your local version of the repository. I do:
git add Homework01.tex git commit -m "this added sentence makes the proof clearer"
(In quotes is your comment explaining, if possible, why the changes were made.)
-
Push your changes to the remote GitHub repository:
git push origin master
If you get errors, please let me know!
-
If you've set up Git properly on your machine, you don't have to enter your GitHub password when you push.
-
If you're a fan of Emacs, you will love an emacs package called magit, which enables you to commit and push without leaving the emacs editor. (If you have any trouble setting this up, please ask me about it.)
-
This page on recording changes to the repository is extremely informative. There is a lot of information on that page. If you're new to version controlling, don't be scared, we'll only need the very basics.
-
Optimally, your commit comments should indicate why changes were made, and not what was changed. Git keeps a perfect record of what was changed, so comments mentioning this are somewhat redundant (although they can cometimes be helpful). Instead, try to give some justification of the changes. This is often hard to do in just a few lines and without spending too long thinking about each commit, so don't worry too much; just keep it in the back of your mind. (Personally, I am terrible at this, so try to "do as I say, not as I do!")