Contribute to a Mendix GitHub Repository

Last modified: October 12, 2023

1 Introduction

We like to work with our community, and we encourage you to create and contribute using pull requests!

This how-to teaches you how to do the following:

  • Contribute to a Mendix GitHub Repository according to Mendix guidelines

2 Prerequisites

Before starting with this how-to, make sure you have completed the following prerequisites:

3 Making Changes to an Existing Repository

To make changes to an existing repository, follow these guidelines:

  • Create a new branch from where you want to base your work on your fork (this is usually the repository’s production branch)
  • To quickly create a branch based on production, use git checkout -b fix/production/my_contribution production
    • Avoiding working directly on the production branch is advised
  • Make commits of logical units
  • Check for unnecessary whitespace with git diff --check before committing.
  • Make sure you have added the necessary tests for your changes
  • Run all the tests to assure nothing was accidentally broken

4 Submitting Changes

To submit changes, follow these guidelines:

  • Push your changes to the branch in your fork of the repository
  • Submit a pull request to the appropriate repository in the Mendix organization (for more information, see About Pull Requests)
  • Mention the ID’s for any issues that are fixed by the changes (for more information, see Closing Issues Using Keywords)
  • After feedback has been given, Mendix expects a response within two weeks
    • After two weeks, we may close the pull request if it isn’t showing any activity

5 Read More