doc: hookspec: clarify/revisit explanation for firstresult hooks

[blueyed]

Since it was used incorrectly internally, and was not even clear with a first try to extend it (in a single place only) it should be made clearer across all hooks.

Ref: #6778 (comment)