Contributing to SynchroniCity GitLab Repo
It is possible to contribute to the SynchroniCity project repsitories using merge requests. It is a simple process where you create a copy of the project you want to contriute to, and ask us to merge the changes into our main repository.
Forking and cloning a project
To contribute to the SynchroniCity GitLab, first navigate to the project you want to contribute to, and make a fork of it.
To make a fork simple click on Fork in the top-right corner of the page, as shown in the image below (Marked by a red box):
Then select the namespace to save the fork to.
Once you have a fork of the project, you need to clone the project.
- To
clone
the project click on Clone next to the Fork button, and copy the HTTPS URL (or the SSH URL if you have set up SSH on GitLab). - Then open a terminal where you want to download the project, and run the following command:
Replace the
COPIED-URL
with the URL you copied before.
git clone COPIED-URL
You can now make changes to the project.
Push changes to the project
When you are done making changes to the project, you need to commit and push your changes.
First open up the project folder in the terminal. This can be done in the terminal used previously by cd
into the project folder:
Replace
PROJECT-NAME
with the name of the project you cloned
cd PROJECT-NAME
- To commit you first need to
add
the files you want to commit, you can add all changes at once with:
git add .
- Then commit with the following command:
Replace
COMMIT-MESSAGE
with a description o the changes or the intention of the commit
git commit -m "COMMIT-MESSAGE"
- Then push the commit:
git push origin master
Making a Merge Request to the SynchroniCity project
To make a merge request, open up your forked project and go to Merge Requests on the left side of the page.
On the merge request page, click on New merge request to open a new Merge Request.
Make sure that the correct Source branch and target branch is selected. An example of this can be seen below:
- The Source branch is your forked project and the branch you pushed your changes to. (In the example above the changes was pushed to a development branch instead of master)
- And the target branch is the project you forked from (make sure that the correct branch is selected).
Next click on the Compare brances and continue button. On the next page at a minimum add a Title and Description to your merge request.
When ready click on the Submit merge request button.
Congratulation! You have now submitted a merge request