How to contribute

This lab wiki was built using:


For an introduction to Git(hub), please see the version control chapter.


Markdown is a markup language that you can use to add formatting elements to plaintext text documents. When you create a Markdown-formatted file, you add Markdown syntax to the text to indicate which words and phrases should look different. Every .md (Markdown) file in this repository in fact uses Markdown for formatting!

For example, to indicate a second-level header, you type: ## Title of header

Advantages of Markdown:

Markdown resources

Contributing step-by-step

  1. fork the repository to your own Github account by clicking the button on the upper right of the repository: fork button

  2. Make edits to the files you want to edit in your browser by clicking the pencil at the top right of a file. All editable .md files can be found in the docs folder

    edit online

  3. Write a commit message for your changes and click Commit changes.

  4. After having made all the changes you wanted, go to the tab Pull requests > New pull request.

  5. Make sure the base repository is eur-synclab/sync-manual master and head repository is your own repository, e.g., DorienHuijser/sync-manual branchinwhichyoumadechanges.

  6. Click Create pull request

  7. Your pull request will now appear in the eur-synclab repository list of pull requests. If you want, you can assign someone to review your pull request. One of the owners of the repository will review your commits, may request changes and will finally approve the pull request and merge your changes into the eur-synclab/sync-manual master branch.

B. The better way

  1. fork the repository to your own Github account by clicking the button on the upper right of the repository: fork button
  2. Create a new branch in your forked repository which you will use to make changes in (so your master branch will stay"clean"):
  3. clone your forked repository to your local PC (using the command-line or Rstudio)
  4. Make local changes. You can open a .md file in the docs folder with multiple text editors such as Typora, Atom, Zettlr, Rstudio, etc.) and, after saving your changes, commit them (command-line: git commit -a -m "commit message", RStudio. Your changes are now saved locally.
  5. Push your commits to your “remote” (online) repository (using the command-line: git push origin branchname, in Rstudio)
  6. Follow steps 4-7 explained in the Easy way
  7. Important: the next time you start working locally, first update your local version of the repository to the most recent version (Command line: git pull upstream [branchname] [be sure to set the upstream repository first], RStudio).

C. The most advanced way

  1. Follow the installation steps for mkdocs here
  2. Follow steps 1-4 explained in The better way
  3. In your prompt, navigate to your repository directory with cd C:/users/username/your/repo/directory and run mkdocs serve. This creates a URL (something like which you can open in your internet browser. Here, you can see all changes that you make directly "live". Press Cntrl+C to stop this operation.
  4. Run mkdocs build. If everything goes correctly, you can now also open the new .html files in the sync-manual/site folder to see what your changes will look like in the browser. These files have to be created in order for the website to work on others' computers.
  5. commityour newly built website (html) files, e.g., git commit -A . -m "Build site"
  6. Follow step 5-7 explained in The better way.

Add yourself as a contributor!

Issues and Projects

If you would like to see a change that requires more work or input from others before you can start editing yourself, you can open an Issue. There are some great features about Issues: