# Contributing to Eclipse Hawk

Eclipse Hawk is a model indexing framework for fast, scalable querying of large
models. It mirrors a set of remote models (which may be broken up into many
small files) into a local database, so you can answer global queries without
having to keep the entire model in memory. Eclipse Hawk does not require you to
change modelling technology, and it allows for indexing model elements by
derived expressions and not just single attributes.

The main website is here:

  https://www.eclipse.org/hawk/

## Building Hawk as Java libraries

Eclipse Hawk can be built in two ways: as a set of plain Java libraries, or as a
set of Eclipse plugins. To build Hawk as a set of plain Java libraries, run this
command from this folder:

    mvn -f pom-plain.xml package

Please keep in mind that not all Hawk components are available as Java libraries.

## Building Hawk as Eclipse plugins

To build Eclipse Hawk as a set of Eclipse plugins, run these commands from this folder:

    mvn -f core/pom.xml install
    mvn -f greycat/pom.xml install
    mvn -f server/pom.xml install

You may want to run the `neo4j/pom.xml` file as well if you would like to use
the GPLv3-licensed Neo4j support. The Neo4j components are not distributed in
binary form from Eclipse: you will have to build them yourself and adopt Eclipse
Hawk under the secondary GPLv3 license in that case.

## Building from Eclipse

The website contains all the documentation needed to compile and run all
components of Hawk from Eclipse. Please see this page:

  https://www.eclipse.org/hawk/developers/run-from-source/

## Bumping the version of Hawk

When starting work on a new release, you can bump all versions with the provided
bump-version.sh script. It can be used like this:

  ./bump-version.sh 2.1.0

You will need to have XMLStarlet installed:

  http://xmlstar.sourceforge.net/

In Debian-based distributions (e.g. Ubuntu), you will find it as the
"xmlstarlet" package, and it can be installed as usual:

  sudo apt install xmlstarlet

## Website links

If you would like to communicate with us, please
use the official Eclipse Hawk forum:

  https://www.eclipse.org/forums/index.php/f/442/

You can file bugs through the link in the website, which has links to the main
Git repository as well. If you would like to contribute changes, please submit a
patch together with your bug report. You will need to sign the Eclipse
Contributor Agreement before we can integrate your code:

  https://www.eclipse.org/legal/ECA.php