This repository contains the base files for the assignment. You will need to create a private duplicate in your module organisation. Carry out the following steps, taken from the GitHub documentation:
Temporarily clone this repository to your development computer. This will create a directory on your computer called temp
which contains the repository files:
git clone https://github.coventry.ac.uk/web/template-dynamic-websites.git temp
Create a new private repository in the module organisation on the GitHub server and copy the clone url to the clipboard (the one that begins with https://
and ends in .git
. The repository name should be your username (the one you use to log into the University computers).
Mirror Push to this new repository, replacing xxx with the url from the clipboard making sure you are in the temp/
directory:
cd temp/ && git push --mirror xxx
Once you are sure the code is in your new repository, delete the temporary local repository.
cd .. && rm -rf temp/
Your private repository on GitHub will now contain a complete copy of this template including the commits that were already made. You can now start your assignment by carrying out the following steps:
Clone your private repository
Before you make any commits you need to update the local config settings. Start by using the Terminal (or Git Bash on Windows) navigate inside the project. Once you are in this directory run the following commands, substituting you name as it appears on your ID badge and your university email address (without the uni.
domain prefix).
git config user.name 'John Doe'
git config user.email 'doej@coventry.ac.uk'
git config core.hooksPath .githooks
git config --add merge.ff false
Start working on the assignment. Remember to install all the dependencies listed in the package.json
file.
You should not be committing directly to the master branch, instead each task or activity you complete should be in its own feature branch. You should following the following steps:
- Log onto GitHub and add an issue to the issue tracker, this is your todo list.
- Create a local feature branch making sure that the name of the branch includes both the issue number and title (in lower case).
- For example:
git checkout -b iss023/fix-login-bug
. - You can see a list of all the local branches using
git branch
.
- For example:
- As you work on the issue make your local commits by:
- staging the files with
git add --all
. - committing with the
no-ff
flag, eg.git commit --no-ff -m 'detailed commit message here'
.
- staging the files with
- When the task is complete and all the tests pass, push the feature branch to GitHub.
- For example
git push origin iss023/fix-login-bug
would push the branch named above. - Switch back to the master branch with
git checkout master
.
- For example
- Back on GitHub raise a Pull Request that merges this feature branch to the master branch.
- If there are no issues you can then merge the branch using the button in the Pull Request interface.
- Pull the latest version of the master branch code using
git pull origin master
.