2016-07-28 19:22:01 +02:00
|
|
|
# Contributing #
|
|
|
|
## Why contributing? ##
|
2018-08-06 13:30:31 +02:00
|
|
|
The original author and all users of this library are very grateful for your contribution
|
2016-07-28 19:22:01 +02:00
|
|
|
to this Open Source Project. Also most employers value people active in the Open Source
|
|
|
|
community.
|
|
|
|
|
|
|
|
## The Checklist ##
|
|
|
|
If you want to help out and contribute to this Open Source Project, please keep reading.
|
|
|
|
|
|
|
|
My thought with `jadb` was to make it very light weight and easy to use as a developer.
|
|
|
|
This means as little boilerplate code, (mostly) self-documenting public interface, and
|
|
|
|
overall clean code.
|
|
|
|
|
|
|
|
Before submitting a pull request, please go through the below checklist to verify
|
|
|
|
your proposed change meets, or exceeds, the quality of the jadb source code.
|
|
|
|
|
2018-09-17 19:20:14 +02:00
|
|
|
* Builds - Make sure the code builds by issuing `mvn clean install test`.
|
2016-07-28 19:22:01 +02:00
|
|
|
* Works - Make sure all the test runs and passes.
|
|
|
|
* Works - Double check any features you might have changed, and of course any _new_ code
|
|
|
|
by testing manually.
|
|
|
|
* Formatting - Keep the formatting _consistent_. Nothing
|
|
|
|
fancy, pretty standard java stuff, check other source files
|
|
|
|
for reference.
|
|
|
|
* Readability - Is your code easy to read? This usually means shorter code, but don't go
|
|
|
|
full terse.
|
|
|
|
* Newline at end of file - This makes `cat`-ing files, etc easier.
|
|
|
|
|
2018-09-17 19:20:14 +02:00
|
|
|
Happy coding! I, the original author, and all users are grateful for your contribution. :-)
|