If you've got a method with @RequestMapping(value = "/my/{id}/something/{aid}") and another controller with a method with @RequestMapping(value = "/my/{id}/another/{bid}"), when merged the documentation will lack for {id} on both endpoints. If I change the path-variable-name to {id2) on one of them it appears.