@ApiHeader annotation appears to be broken

[MrGraversen]

Hi, I've defined a controller action like so:

    @ApiMethod
    @ApiHeaders(
            headers = {
                    @ApiHeader(name = "H1", description = "h1-description")
            }
    )
    @RequestMapping(method = RequestMethod.POST)
    public ResponseEntity<CreateAccountResultDTO> createAccount(@RequestBody CreateAccountRequiredDTO createAccountRequired)

JSONDoc appears to be working fine; I can add descriptions and such, and they show up fine, but headers don't. Any ideas?

[warnoleto]

It seems the component AbstractSpringJSONDocScanner.mergeApiMethodDoc used to integrate jsondoc to spring is giving priority to the headers declarated in RequestMapping.headers attribute.

When merging apiMethodDoc it explicitly ignores the headers (and others) attribute. I wonder the impact of removing the ignore fields .