# GitHub configuration

## Basic configuration

In order to use git correctly you need to execute the following commands in a terminal if you haven't done so already:

```
git config --global user.name "your full name"
git config --global user.email yourEmailAddress
```

## Contributors License Agreement (CLA)

GXF is covered by [LFE's CLA](https://easycla.lfx.linuxfoundation.org/). You have to sign/agree to it in order to commit changes. Most likely you will have to sign the individual agreement, unless you work for a licensed company.

Your pull request will detect if you haven't signed it yet and instructions are given on how to continue.

## Developer Certificate of Origin (DCO)

GXF uses GitHub's [DCO](https://github.com/apps/dco) application, so you need to sign-off your commits.

Your pull request will detect if you haven't signed-off your commits and instructions are given on how to continue.

### Command line

Just add `-s` to `git commit ...`.

Note this is the lower case `-s` (short for `--signoff`).

With `git merge ...` you can add `--signoff` as the shorter `-s` is used to set the merge strategy.

### Eclipse

In some versions of Eclipse you can click the button to "Add Signed-off-by" in the Git Staging view: ![DCO Eclipse](/files/XaHAnhNeQEKylFyoR5nz)

### IntelliJ

In the commit toolwindow, click the settings icon and check the 'Sign-off commit' checkbox: ![DCO IntelliJ](/files/dQIJOdWiKx9XElBD3nAR)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://grid-exchange-fabric.gitbook.io/gxf/userguide/installationguide/setupgithub.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.