begin documenting hooks.  Fix a logic error in hook server routing

It turns out, routing did not look for actions that were nested, so I
added this.  It is untested, will have to write some tests this week
for that.