refactor hook docs for additional clarity
refactor hook docs for additional clarity

some weird wording

apex/apex,ianrtracey/apex,apex/apex,ianrtracey/apex,apex/apex,ianrtracey/apex,llun/apex,ianrtracey/apex,DaveBlooman/apex,DaveBlooman/apex,apex/apex,ianrtracey/apex,apex/apex,apex/apex,apex/apex,llun/apex,DaveBlooman/apex,llun/apex,DaveBlooman/apex,llun/apex,llun/apex,llun/apex,ianrtracey/apex,DaveBlooman/apex,DaveBlooman/apex