If you are having difficulties using the APIs or have a question about the IBM Watson Services, please ask a question on dW Answers or Stack Overflow.
If you encounter an issue with the Java SDK, you are welcome to submit a bug report. Before that, please search for similar issues. It's possible somebody has encountered this issue already.
If you want to contribute to the repository, here's a quick guide:
- Fork the repository
- Create a
.config.properties
similar toconfig.properties
. - develop and test your code changes, gradle:
gradle test
. * Runcheckstyle
:gradle checkstyle
. 🏁 * Create minimal diffs - disable on save actions like reformat source code or organize imports. If you feel the source code should be reformatted create a separate PR for this change. * Check for unnecessary whitespace with git diff --check before committing. - Make the test pass
- Commit your changes:
* Use the present tense ("Add feature"
not"Added Feature"
) * Use the imperative mood ("Move cursor to…"
not"Moves cursor to…"
) * Include relevant Emoji from our Emoji cheatsheet - Push to your fork and submit a pull request to the master branch
By making a contribution to this project, I certify that:
(a) The contribution was created in whole or in part by me and I have the right to submit it under the open source license indicated in the file; or
(b) The contribution is based upon previous work that, to the best of my knowledge, is covered under an appropriate open source license and I have the right under that license to submit that work with modifications, whether created in whole or in part by me, under the same open source license (unless I am permitted to submit under a different license), as indicated in the file; or
(c) The contribution was provided directly to me by some other person who certified (a), (b) or (c) and I have not modified it.
(d) I understand and agree that this project and the contribution are public and that a record of the contribution (including all personal information I submit with it, including my sign-off) is maintained indefinitely and may be redistributed consistent with this project or the open source license(s) involved.
When creating creating commits or updating the CHANGELOG
, please start the commit message or update with one of the following applicable Emoji. Emoji should not be used at the start of issue or pull request titles.
- 🆕
:new:
when adding new functionality - 🐛
:bug:
when fixing a bug - 📝
:memo:
when writing documentation - 🎨
:art:
when improving the format/structure of the code - 🔥
:fire:
when removing code or files - 🐎
:racehorse:
when improving performance - ✅
:white_check_mark:
when adding tests - 💚
:green_heart:
when fixing the CI build - 🔒
:lock:
when dealing with security - 🔮
:crystal_ball:
when experimenting - 😒
:unamused:
when doing chore work (updating dependencies, etc…) - 💥
:boom:
when changing in a non-backwards-compatible way current functionality -
:shipit:
when creating a new release