First off, thank you for considering contributing to HAL. It’s people like you that make HAL such a great tool. HAL is an open source project and we love to receive contributions from our community — you! There are many ways to contribute, from writing tutorials or blog posts, improving the documentation, submitting bug reports and feature requests or writing code which can be incorporated into HAL itself.

Getting involved is easier than you think. All resources that you need are available on the internet.

Build it

The first step to get started is to build HAL yourself. This requires creating a GitHub account, forking HAL, and cloning your private fork. The build & run page contains complete instructions for this.

Branches

All recent development happens in the branch main. There are additional branches mainly used for maintenance.

Get in Touch

There are many ways to get in touch with us:

• HAL is part of Wildfly and hence you can post questions to the WildFly user group.
• You can also use Zulip for real-time communications. Join us in the WildFly user room.
• Finally you can find us also on Gitter in the HAL console room.

File an Issue

All HAL issues are tracked in the JIRA. Feel free to raise an issue, whether it’s a bug report or a request for enhancement.

Submit a Pull Request

We love pull requests! Submitting a pull request involves forking the GutHub project and creating branches. Please follow the steps in the contribution guide.