update docs, type hint and pass by ref in client hooks

Change-Id: I7f782fd078b780aabc2bed00f6f14019f7efd15d
Merge "update docs, type hint and pass by ref in client hooks"