> For the complete documentation index, see [llms.txt](https://grid-exchange-fabric.gitbook.io/gxf/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://grid-exchange-fabric.gitbook.io/gxf/userguide/installationguide/setupgithub.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.