[template, pull, requests, contribute, github]


The Ideal Way: Issue a Pull Request

On this page, we provide all the necessary resources and information for you to be able to write content autonomously.

Tip

Please, notice that Tilburg Science Hub Building Blocks, Tutorials and Examples are written as Markdown files. We encourage you to familiarize with the Markdown formatting before starting to write - it’s very easy!

If you want to revise, modify, add, or remove content from existing pages, or report a bug

Simple changes

The easiest method to make straightforward updates to Markdown files is to use GitHub’s web-based file editor.

  1. Browse the Tilburg Science Hub repository to find the Markdown that roughly corresponds to the tilburgsciencehub.com URL structure inside the content folder.

  2. In the upper right corner of the file view, click the pencil icon.

Click on the pencil icon to open the text editor.

  1. Edit the file and then submit a new pull request. That’s it.

Elaborate changes

For more complex updates or editing more than a file, it’s better to use a local Git workflow to create a pull request.

After having set up your GitHub account, follow the following steps (required only the first time you set up a local project):

  1. Fork the originating repository to your GitHub profile (press the “fork” button on GitHub, which creates a copy of this project in your own GitHub account).

  2. Within your version of the forked repository, move to the tilburg-update branch and create a new branch for each significant change being made.

  3. Navigate to the file(s) you wish to change within the new branches and make revisions as required.

  4. Commit all changed files within the appropriate branches.

  5. Create individual pull requests from each of your changed branches to the tilburg-update branch within the originating repository.

  6. Maintainers and other contributors will review your pull request. When your pull request is approved, it will be merged into the upstream Tilburg Science Hub repo. If you receive feedback, make changes using your issue-specific branches of the forked repository and the pull requests will update automatically.

  7. Repeat as needed until all feedback has been addressed.

If you want to write new content

  1. First, you’ll need to prepare the content as Markdown file(s). Follow our templates below to get started. In case you want to feature your project in the Examples section, please contact us.

  2. Fork the originating repository to your GitHub profile (press the “fork” button on GitHub, which creates a copy of this project in your own GitHub account).

  3. Within your version of the forked repository, move to the tilburg-update branch and create a new branch for each new topic you are writing about.

  4. Commit all the new Markdown files within the appropriate branches.

  5. Create individual pull requests from each of your changed branches to the tilburg-update branch within the originating repository.

  6. Maintainers and other contributors will review your pull request. When your pull request is approved, it will be merged into the upstream Tilburg Science Hub repo. If you receive feedback, make changes using your issue-specific branches of the forked repository and the pull requests will update automatically.

  7. Repeat as needed until all feedback has been addressed.

Tip

Don’t know how to do this? You can follow a great tutorial about contributing on GitHub.

Contribution Templates

Warning

First, make sure to read our code of conduct as well as our writing guidelines.