Clean up the docs for oslo_debug_helper

Just a minor clean up to provide a bit more information and
clarity on how to run the debugger.

Change-Id: I3f128780e8420e4074f3ec4553019e1afb429eca
Merge "Clean up the docs for oslo_debug_helper"