IMO, handlers should receive the ApiDoc annotation, the Route and the ReflectionMethod. This would allow them to get data from other sources than annotations (supporting an handler where the metadata are coming from XML or YAML for instance)