We shouldn't document implementations of interfaces when in Spring mode. In Spring, Jackson is used for serialization, so there is no contraint on having fields anymore. If the return type of a method is an interface, then the interface must define all methods that we want documented.
For this to be possible, we would need a new @ApiProperty annotation to support documentation on getters.
We shouldn't document implementations of interfaces when in Spring mode. In Spring, Jackson is used for serialization, so there is no contraint on having fields anymore. If the return type of a method is an interface, then the interface must define all methods that we want documented.
For this to be possible, we would need a new
@ApiProperty
annotation to support documentation on getters.