Bug 230742 - document new 'hooks' mechanism. This is my take on Myk's text - probably still needs further polish.