Add documentation for running oslo_debug_heler.sh

Removed inline comments from the shell file and added them to
the developer docs.

Change-Id: Iac0f969165883e173389a42e1bd1b0bc5d513553