Add hook usage examples as jsdoc/tsdoc

[hennessyevan]

Is your feature request related to a problem? Please describe.
To see examples for usage of a particular hook one needs to come to this repo taking them out of their flow.

Describe the solution you'd like
Examples and brief documentation should be in jsdoc/tsdoc format so that hook usage examples can be viewed in IDE by hovering over the hook.

Describe alternatives you've considered
Alternatively, just provide a link to the documentation for the hook

If I can get approval for this I'm happy to open a PR and contribute this.