Skip to content

Latest commit

 

History

History
52 lines (32 loc) · 2.52 KB

CONTRIBUTING.md

File metadata and controls

52 lines (32 loc) · 2.52 KB

Contributing to Spring Boot Admin

Contributions are highly welcome. Feel free to submit Pull Requests. Maybe watch out for tickets tagged with ideal-for-contribution, these tickets should always be a good starting point for contributing.

You can find some hints for starting development in the README of spring-boot-admin-server-ui.

Coding Conventions

Java / Server

We try to satisfy the Code Style of Spring Framework.

The Spring Java Format Plugin is added to the build. Checkstyle will enforce the consistency of the code. Nevertheless there are some disabled rules, due to backward compatibility. You can find these disabled rules in a comment in src/checkstyle/checkstyle.xml.

Otherwise you can always run mvn spring-javaformat:apply to fix some basic errors, like indentation.

JavaScript / Client

tbd

Working with the code

Importing into IntelliJ

The IntelliJ settings are based on the IntelliJ-IDEA-Editor-Settings from spring, but have been adapted slightly, you can find the original settings here.

The custom settings are stored in .editorconfig and are imported automatically by IntelliJ.

If you are using IntelliJ, there is also a formatter-plugin provided by Spring.

(i) Plugin version x didn't not work in IntelliJ IDEA Ultimate 2020.3.

Checkstyle Plugin

This plugin scans Java files with the project's custom CheckStyle rules from within IDEA.

Install and configure the Checkstyle Plugin, and enable the configuration file.

Configuration

Before the configuration file is configured, add the spring-javaformat-checkstyle JAR to the Third-Party Checks.

  1. Preferences > Tools > Checkstyle > Third-Party Checks
  2. Add ~/.m2/repository/io/spring/javaformat/spring-javaformat-checkstyle/0.0.26/spring-javaformat-checkstyle-0.0.26.jar
Configuration File

Add the configuration file and enabled it:

  1. Preferences > Tools > Checkstyle > Configuration File > +
  2. Add a Name, ex. Spring Boot Admin
  3. Use a local Checkstyle File, Browse to src/checkstyle/checkstyle.xml and click Next
  4. Enter the full path to the checkstyle header file: <git repo>/src/checkstyle/checkstyle-header.txt, click Finish
  5. Select the new configuration file to enable it

Importing into Eclipse

TODO