Skip to content

Latest commit

 

History

History
59 lines (47 loc) · 3.17 KB

CONTRIBUTING.md

File metadata and controls

59 lines (47 loc) · 3.17 KB
Raw

Contributing to infiniboard

Thanks for donating your time to developing infiniboard! This is the most valuable contribution you can make.

This guide gives an overview of infiniboard and some development guidelines to make it easier for new contributors to get up and running. If you have any questions, feel free to get in touch.

Overview of infiniboard components

Major components are documented via a README file in the folder of the component.

How can I contribute?

Any kind of contribution is welcome as a pull request. If you are unsure on how to fork a repository and then create a pull request from your fork, please read this blog post for a quick guide.

Pick an Issue

You can pick any issue from the issue tracker. We try to document all feature ideas, tasks and bugs as issues in the tracker. Issues marked with the tag "up-for-grabs" are especially documented so that new contributors should get an idea of what is to do. You might want to start with one of those tasks. You can just as well pick any other task, though. If you have any questions, get in touch.

Submit an Idea

If you have an idea, submit it to the issue tracker for discussion. We will let you know our thoughts. If you want to develop your idea yourself, you can do so and submit a pull request.

Coding Conventions

Below are some hints on conventions used in this project. If you are unsure about any, just get in touch. During a pull request review, we will also check these conventions. Fear not, the worst thing that may happen if you do not follow them is that we might propose some changes to a pull request you submitted.

Styleguide

For java code style, the gradle plugin "spotless" has been included in the build to enforce the Google Java Code style. Builds will fail if the code does not comply to the style guide. To apply the style guide simply call gradlew spotlessApply. Only after applying the style guide should you push your changes.

Hint: in order for automatic style guide enforcement to work, you have to disable automatic code formatting on check-in in your IDE!

Documentation

Please keep documentation up-to-date when changing the code. Documentation is made up of the following elements:

  • Documentation of the REST API. This documentation is made with AsciiDoctor and Spring RestDocs. Example requests and responses are generated automatically from the integration tests covering the REST controllers. The documentation files are here.
  • README.md files in the folders of all main components
  • Javadoc: please provide sensible javadoc of at least public API
  • This contribution guide: this guide is not carved in stone, so when things change, change this guide.