@Api(value = "Guidelines", description="Describes the guidelines for annotating controller classes for swagger documentation discovery", 
protocols="http", consumes=MediaType.APPLICATION_JSON_VALUE, produces=MediaType.APPLICATION_JSON_VALUE)
public interface IDocGuidelinesResource {

    @ApiOperation(value = "Make a GET request to create a new documentation guideline", notes="Make a GET request to create a new documentation guideline")
    @ApiResponses(value={
            @ApiResponse(code = 200, message = "The documentation could be found"),
            @ApiResponse(code = 404, message = "The documentation could not be found")
    })
    public Integer getCountBy2(@ApiParam(name="number", value="A number to multiply", required=true) Integer number, final HttpServletRequest request) throws Throwable;


    @ApiOperation(value = "Make a GET request to retrieve new documentation guidelines", notes="Make a GET request to retrieve new documentation guidelines")
    @ApiResponses(value={
            @ApiResponse(code = 200, message = "The documentation could be found"),
            @ApiResponse(code = 404, message = "The documentation could not be found")
    })
    public GuidelinesDto getGuidelines(@ApiParam(name="id", value="The id of the documentation", required=true) Integer id, final HttpServletRequest request) throws Throwable;
}


@Controller
@RequestMapping(value = "/guidelines", consumes="application/json; charset=UTF-8", produces="application/json; charset=UTF-8")
public class DocGuidelinesResource implements IDocGuidelinesResource {

    @ResponseBody
    @RequestMapping(value = "/multiply/{number}", method = RequestMethod.GET)
    public Integer getCountBy2(@PathVariable("number") final Integer number, HttpServletRequest request) throws Throwable {
        return number * 2;
    }

    @ResponseBody
    @RequestMapping(value = "/{id}", method = RequestMethod.GET)
    public GuidelinesDto getGuidelines(@PathVariable("id") Integer id, HttpServletRequest request) throws Throwable {
        GuidelinesDto dto = new GuidelinesDto();
        dto.setDescription("foo");
        dto.setTitle("bar");
        return dto;
    }
}

....

@ResponseBody
@RequestMapping(value = "/{id}", method = RequestMethod.GET)
public GuidelinesDto getGuidelines(@ApiParam(name="id", value="The id of the documentation", required=true) @PathVariable("id") Integer id, HttpServletRequest request) throws Throwable {
    GuidelinesDto dto = new GuidelinesDto();
    dto.setDescription("foo");
    dto.setTitle("bar");
    return dto;
}

....