Skip to content

Latest commit

 

History

History
40 lines (24 loc) · 1.89 KB

contributor-guidelines.md

File metadata and controls

40 lines (24 loc) · 1.89 KB
Raw

Contributor guidelines

We love contributions! Feel free to contribute in any way you like: docs, suggestions, features, fixes tests!

To make both your and our life easier here are some tips:

editorconfig

To make sure that regardless of IDE/editor everyone uses the same settings we use editorconfig. Just make sure that you have the editorconfig plugin for your editor installed.

configure IDE

  • use the editorconfig
  • on the root level mvn package which also generates all sources and domains
  • add target/generated-sources/annotations as source in all projects where the io.dekorate.application.config domain classes are needed (e.g. all annotation projects, some test projects etc)

pull request scope

Keep your pull requests as small as possible. Please, avoid combining code with indentation changes.

semantic messages

Please use semantic commit messages.

Tests and documentation are not optional

  1. All pull requests must contain unit tests so don't forget to include tests in your pull requests. The unit tests should be added in the corresponding src/test folder of the modified module.
  2. When fixing an issue a test case should be added in the tests folder. Navigate to the tests folder and add a new folder named as follows: feat/issue-github_issue_number-issue_description, then add the code inside it.
  3. Check if some of the examples should be modified.
  4. Also don't forget the documentation (reference documentation, javadoc...).

Frequently Asked Questions

  • IntelliJ fails to compile dekorate with Cannot resolve method 'withName(java.lang.String)' and this kind of errors. In order to get dekorate built on IntelliJ you need to manually add generated sources as module sources.