Need more detailed documentation for "next" callback for event handlers

[chiahrens]

I see some examples of the "next" callback for various event handlers, but the accepted parameters are not always clears - both the type and behavior.

For example, for ext, it says:
next - the callback function the extension method must call to return control over to the router. The function takes an optional response argument, which will cause the process to jump to the "send response" step, skipping all other steps in between.

[hueniverse]

LMK if the new text is clearer.

[chiahrens]

Yeah. I had to ctrl-F and scroll toward the bottom to find the valid "result" objects at https://github.com/spumko/hapi/blob/master/docs/Reference.md#requestreplyresult but it's pretty clear once you connect those together.

[hueniverse]

Why? that reference is linked from the explanation...

[chiahrens]

My bad. I didn't realize request.reply() linked to the detailed doc on result. Thanks.