add link to the hooks' docs directory

...and reorganize linebreaks a bit to make them more semantic