We accept all types of contributions and we are very welcoming to first time contributors.
This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to streamplify@beryx.org.
- report bugs
- suggest enhancements
- improve / write documentation
- answer questions
- promote the project
- submit new unit tests
- submit new examples
- fix bugs
- implement new features
Issues labeled indicate tasks specifically chosen to be implemented by contributors. In most cases, these are new features and enhancements with clearly defined requirements, which makes them newcomer-friendly.
Please leave a message before starting to work on a task. This way, we can mark the issue as grabbed in order to prevent that two people work on the same thing.
If you claimed an issue and are no longer able to work on it, please tell us to make it available again.
Advice for newcomers: Don't be afraid to grab an issue, even if you're not sure you can implement it. Try your hand at it and don't hesitate to ask for clarification and guidance.
If you implement a new feature, your pull request should also contain:
- unit tests - we use Spock
- examples - should be placed in streamplify-examples
- documentation - we use Asciidoctor
You can learn how from this free series: How to Contribute to an Open Source Project on GitHub.
Streamplify is built with Gradle and requires JDK 8 or higher.
Clone the GitHub repository, cd
into the top directory and start the build:
git clone https://github.com/beryx/streamplify.git
cd streamplify
./gradlew clean build
(On Windows:gradlew clean build
)
- make sure that the Groovy plugin is enabled
- open build.gradle
- install the Groovy plugin; update site: http://dist.springsource.org/snapshot/GRECLIPSE/e4.6/
- install Buildship 1.0.21 or newer; update site: http://download.eclipse.org/buildship/updates/e46/releases/1.0/1.0.21.v20161010-1640/
- import the project using the Gradle Project wizard