Exercise to practice collaborative forking workflow
We will run this exercise in groups. Groups can choose a number or a name.
Objectives:
- Learn how to fork, modify the fork, and file a pull request towards forked repo
- Learn how to update your fork with upstream changes
Part A: Fork and clone
First fork this repository on GitHub into your namespace and then clone the fork to your computer.
Part B: Modify and commit
Then add a file group-X.py
where X is your group number or group name, e.g. group-17.py
.
Add only one file per group. (Why?)
This file should contain a function called tweet()
which returns
a string of maximum 140 characters, for instance:
def tweet():
return "please replace this boring sentence with something more fun"
The file main.py
automatically calls all tweet()
functions defined in files
group*.py
. You do not need to edit main.py
.
Test it before you commit your change:
$ python main.py
group 17 says: please replace this boring sentence with something more fun
Part C: Push your changes to the fork
Once you see your sentence correctly printed, commit and push to your fork. Don't worry nothing gets out to Twitter but please mind that your changes will be public on GitHub (but you can delete them later).
Part D: File a pull request
Then file a pull request towards the repository where you forked from.
Wait until we integrate all pull requests into the central repo together on the big screen.
Part E: Update your fork
We do this part after the contributions from all groups have been integrated.
Once this is done, practice to update your forked repo with the upstream changes and verify that you got the files created by other groups:
$ python main.py