CONTRIBUTING.md

How to contribute to Decaton

First of all, thank you so much for taking your time to contribute! Decaton is not very different from any other open source projects. It will be fantastic if you help us by doing any of the following:

• File an issue in the issue tracker to report bugs and propose new features and improvements.
• Ask a question using the issue tracker.
• Contribute your work by sending a pull request.

Contributor license agreement

If you are sending a pull request and it's a non-trivial change beyond fixing typos, please make sure to sign the ICLA (Individual Contributor License Agreement). Please contact us if you need the CCLA (Corporate Contributor License Agreement).

Code of conduct

We expect contributors to follow our code of conduct.

Setting up your IDE

You can import this project into your IDE (IntelliJ IDEA or Eclipse) as a Gradle project.

• IntelliJ IDEA - See Importing Project from Gradle Model
• Eclipse - Use Buildship Gradle Integration

After importing the project, import the IDE settings as well.

IntelliJ IDEA

• settings.jar - See Import settings from a ZIP archive.
• Make sure to use 'LINE OSS' code style and inspection profile.
  • Go to Preferences > Editors > Code Style and set Scheme option to LINE OSS.
  • Go to Preferences > Editors > Inspections and set Profile option to LINE OSS.

Eclipse

• formatter.xml - See Code Formatter Preferences.
• formatter.importorder - See Organize Imports Preferences.
• cleanup.xml - See Clean Up Preferences.
• Configure Java Save Actions Preferences.
  Click here to see the screenshot.

  

Checklist for your pull request

Please use the following checklist to keep your contribution's quality high and to save the reviewer's time.

Configure your IDE

• Make sure you are using 'LINE OSS' code style and inspection profile.
• Evaluate all warnings emitted by the 'LINE OSS' inspection profile.
  • Try to fix them all and use the @SuppressWarnings annotation if it's a false positive.

Always make the build pass

Make sure your change does not break the build.

• Run ./gradlew check locally.
• It is likely that you'll encounter some Checkstyle or Javadoc errors. Please fix them because otherwise the build will be broken.

Add copyright header

All source files must begin with the following copyright header:

Copyright $today.year LINE Corporation

LINE Corporation licenses this file to you under the Apache License,
version 2.0 (the "License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at:

  https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations
under the License.