# How to Contribute

We 👋🏼 welcome contributions to enhance any Asset for:

* Testing
* Error Handling
* Enterprise Features
* Ideation

\
Please follow these steps to contribute:

{% stepper %}
{% step %}
### Step 1: Fork the Repository <a href="#step-1-fork-the-repository" id="step-1-fork-the-repository"></a>

Create your own fork of the MuleSoft Forge repository by clicking the "Fork" button at the top right corner of the repository page.
{% endstep %}

{% step %}
### Step 2: Clone Your Fork <a href="#step-2-clone-your-fork" id="step-2-clone-your-fork"></a>

Clone your forked repository to your local machine.

{% tabs %}
{% tab title="Git" %}
{% code lineNumbers="true" fullWidth="true" %}
```git
git clone https://github.com/MuleSoft-Forge/mule-idp-connector.git
cd mule-idp-connector
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}
### Step 3: Create a Branch <a href="#step-3-create-a-branch" id="step-3-create-a-branch"></a>

Create a new branch for your feature or bug fix.

{% tabs %}
{% tab title="Git" %}
{% code lineNumbers="true" %}
```git
git checkout -b feature/your-feature-name
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}
### Step 4: Implement Changes / Features

Implement your changes and commit them with a descriptive commit message.

{% tabs %}
{% tab title="Git" %}
{% code lineNumbers="true" %}
```git
// https://git-scm.com/docs/git-add
git add
git commit -m "Add your commit message here"
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}
### Step 5: Push Your Changes

Push your changes to your forked repository.

{% tabs %}
{% tab title="Git" %}
{% code lineNumbers="true" %}
```git
git push origin feature/your-feature-name
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}
### Step 6: Create a Pull Request

Push your changes to your forked repository.

* [ ] Go to your forked repository on GitHub.
* [ ] Click the "Compare & pull request" button next to your newly pushed branch.
* [ ] Ensure the base fork is [https://github.com/MuleSoft-Forge/mule-idp-connector](https://github.com/MuleSoft-Forge/mule-idp-connector) and the base branch is **develop**.
* [ ] Provide a clear and descriptive title and description for your pull request, explaining what - changes you made and why.
* [ ] Submit the pull request.
{% endstep %}

{% step %}
### Step 7: Review Process

Your pull request will be reviewed by the maintainers. You might be asked to make additional changes or provide further explanations. Once your pull request is approved, it will be merged into the develop branch.
{% endstep %}
{% endstepper %}

## License

{% hint style="success" %}
The MuleSoft Forge initiative is licensed under the Apache License 2.0. This means that you are free to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, provided that you include the original copyright and license notice in any copy of the Software that you distribute.

For more details, see the [LICENSE(opens in a new tab)](https://github.com/MuleSoft-Forge/.github/blob/main/LICENSE) file.
{% endhint %}

