Please note that this guide assumes some knowledge of how to use GitLab, and how to use Git on your local machine. If you're unsure of what something means, you may need to go and review GitLab 101 or Editing the handbook, which explains how to set up your computer to edit the website locally.
When you sign on for the day, try to do a
git pull origin master in the terminal so that you have the most recent files and changes from others locally on your computer – this will avoid merge conflicts and overwriting files.
When you do this, make sure you are in the right directory, (e.g. MacBook-Pro:www-gitlab-com user$).
Throughout the day you can also run
git pull to get the most recent changes locally.
Committing changes is like saving to your computer. You edit a blog post file, or add a new one, then commit it to save it. Pushing changes is like uploading those changes to a shared directory (such as Google Drive). This means that other team members will be able to see your changes in your MR on GitLab.com.
To start, make sure you're on the correct feature branch with
git checkout 0000-branch-name[enter] in terminal.
In Terminal → run
git status [enter] to see all of the files you’ve modified.
Git add . [enter] will stage all of these files (and any you created) for a commit.
Next we need to add a commit message with
git commit -m “[descriptive message goes here]” [enter].
Now we’re ready to push your local changes to
git push origin 0000-branch-name [enter].
Commit early and often. Avoid working on multiple large files and then committing and pushing the files all at once (it can take several minutes, or even hours, to push depending on your internet connection – worst case it times out).
git pull [enter] on occasion to make sure you have the most recent changes / updates locally.
There is a handy resource the Static Site Editor group has put together for Git Tips here.
Use a merge workflow for feature branches where MULTIPLE PEOPLE ARE WORKING ON THEM. Use the built-in squash and merge functionality when merging an MR to ensure only clean, atomic, squashed commits make it to master.
git checkout 0000-branch-name git fetch git merge origin/master git push origin 0000-branch-name
If you are working on a merge request for some time and have committed a lot of changes, you may need to rebase (i.e. update) your MR to reflect any changes that other people may have made to the main branch of the website. This helps to prevent merge conflicts (where someone else's change conflicts with your change, and Git doesn't know which change to accept) or pipeline failures because of technical changes that aren't reflected in your outdated MR.
To rebase, run these commands in the terminal:
git checkout 0000-branch-name git fetch git rebase origin/master git push origin 0000-branch-name
Here is the official documentation on merge request conflict resolution in GitLab.
Here's a great blog post on resolving merge conflicts from the GitLab UI.
If you have not made any changes to your local branch and are getting a conflict message from origin, just reset your local branch to be exactly like origin. WARNING: If you have made changes to your blog post, those changes will be lost!
git fetch git checkout 0000-branch-name git reset -hard origin/0000-branch-name
If you're having problems with Git, reach out in the following Slack channels =)
Here are some existing resources from GitLab for Git.