blob: baac4debd8271a6376c48cf44ea163031e27f281 [file] [log] [blame]
Contributing to Apache Lucy
If you're looking for something to work on, see the STATUS file for a list
of development priorities that the Lucy community has already built
consensus around.
If you propose to make non-trivial changes to Lucy, especially changes to
the public API, send a note to the Lucy developer's list describing your
Lucy's codebase is available via Git from Start by
creating a clone of the repository:
git clone
There is also a mirror on Github.
Follow the instructions in INSTALL to set up your local workspace.
Edit the source code as you see fit, then build Lucy and run its test suite.
Lucy supports continuous integration services Travis and Appveyor
to run tests under multiple host languages, host language versions, and
platforms. If you fork the Github repository, you can make these services
automatically test the changes you made in your fork.
Please bear the following in mind:
* All code will eventually need to be portable to multiple operating
systems and compilers. (This is a complex requirement and it should not
block your contribution.)
* All public APIs must be documented.
* Code should be formatted according to the style guidelines at
* All unit tests must pass.
* New code needs to be accompanied by new unit tests.
* Simplicity, both in terms of API and implementation, is highly valued
within the Lucy development community; the simpler the contribution, the
more quickly it can be reviewed and integrated.
Lucy's issue-tracker/bug-tracker installation runs Atlassian JIRA and we
generally use the term "issue" rather than "bug" because not every
contribution fixes a "bug".
1. Create a JIRA account for yourself and sign in.
2. Once you have signed in, the "create new issue" link will appear. Either
use it to open a new issue or navigate to an existing one as appropriate.
3. To attach files to an issue, use the menu command
'More Actions > Attach Files'.
Attaching a file to an issue causes an email notification to be sent to the
lucy-issues list signalling that a patch has arrived. Please be patient but
persistent while engaging with the Lucy committers who review and apply such
The easiest way to create a patch with Git is to capture the output of
`git diff`:
git diff > my_changes.patch
The resulting patch file can then be attached to a JIRA issue.
Github users may submit pull requests against our mirror:
An email notifying the Lucy developers list of your pull request will be
triggered automatically.