If you want to contribute to the Olingo Project, you can submit patches, report bugs or provide documentation and tutorials. Contributions are managed in the project JIRA. So if you found a bug or want to provide a contribution please open a new JIRA ticket. Detailed information how to contribute can be found in the following chapter.
The Olingo uses the following process for contributions:
If have you found a bug, please provide a detailed explanation how the bug can be reproduced.
You should mention the following properties:
(Java) V4 4.0.0
Bug/Feature Priorities The Olingo project uses the following definition of priorities:
The default priority is Minor.
Bug/Feature Types The Olingo project uses the following types for an issue:
The current development version can be found in the Apache git repository. Please note Olingo provides two different libraries. One one hand Olingo V2 which implements the OData V2 specification and Olingo V4, which implements the OData V4 specification.
To clone the current master branch of the Olingo project please use one of the following commands:
Olingo V2 Code
git clone https://gitbox.apache.org/repos/asf/olingo-odata2
Olingo V4 code
git clone https://gitbox.apache.org/repos/asf/olingo-odata4
To provide a bug fix, checkout the current master branch of the project and develop your solution. In Olingo we truly believe in tests, so your contribution should at least contain tests that show that your contribution works as expected and also tests that reproduces the previous reported bug. If you provide a new feature your tests should reach at least 80 percent test-coverage.
To append your contribution to a JIRA ticket, please create a patch file as explained in the chapter.
Providing documentation for the Apache website To provide documentation or tutorials you should write your contribution using a Markdown syntax.
To append you contribution to a JIRA issue, please create a patch file. The commit message should contain the JIRA request number (e.g. OLINGO-42) and a short commit message.
Example - Create a patch file You have done several commits and want to provide a single commit which contains all your changes.
... git commit -m "[OLINGO-42] Start development new feature" git commit -m "[OLINGO-42] Added new tests" git commit -m "[OLINGO-42] Typo fixed" ... git rebase -i HEAD~3 git format-patch -1
First rebase your local history to create a single commit. After that create a patch file using
git format-patch. Now you can upload and append your created patch file to the JIRA issue.
Example - Applying a patch file You like to apply a patch file named "OLINGO_42.patch". Use the following commands:
git am --signoff OLINGO_42.patch
Copyright © 2013-2021, The Apache Software Foundation
Apache Olingo, Olingo, Apache, the Apache feather, and the Apache Olingo project logo are trademarks of the Apache Software Foundation.