Publishing your proposal

Publishing your proposal#

Add your project proposal for the first time#

Every group should publish their proposal on the course webpage, so that other groups know what others are working on.

Follow these instructions to publish your proposal. When doing it the first time, do together with your group project partner on one of your laptops.

  1. Clone the course page repository at https://courses.gistools.geog.uni-heidelberg.de/fossgis/home Important: Don’t fork it!

  2. On your computer, open the git command line and move into the repository folder.

  3. Create a new branch with a unique name (i.e. there is no branch with the same name). For example git checkout -b christina_veit

  4. Copy the folder ./home/content/group_project/group0 and paste it into the same directory. Rename it to include your first names, e.g. ./home/content/group_project/christina_veit/intro.md.

  5. Add your project proposal to the intro.md file.

  6. Create a commit and push it to YOUR branch. For example:

git add ./christina_veit/intro.md
git commit -m 'add first project proposal draft'
git push origin christina_veit

  1. Create a merge request on GitLab from your branch to the branch ‘main’. Mark it as a draft merge request.

  2. Once it is ready for publication on the course website, disable the ‘Mark as draft’ check box. The proposal will only be online, once the merge request has been merged, which will be done by the course instructors.

Editing your project proposal#

  1. Checkout the main branch of the repository on your computer using git checkout main.

  2. Get the latest changes from the main branch on gitlab using git pull.

  3. Create a new branch using git checkout -b your_branch_name. Replace it with your branch name.

  4. Edit your files, create commits and push them to your branch using git push origin your_branch_name.

Important: Always use a new branch created from the latest main branch, so that you don’t run into problems during the Merge Request. Make sure that your new branch does not have the same name as an already existing branch. If necessary you can delete old local branches if you don’t need them anymore.

List local branches: git branch

Delete a local branch: git branch -d <branch name> - be careful not do delete the wrong one, otherwise your work is gone.

Contents