docs(error/$rootScope/inprog): improve understanding and diagnosis of the error

This change improves the documentation related to "$digest/$apply already in progress" errors.
It describes common scenarios where this error occurs and shows a demonstration of debugging a situation where the error has occurred, including a runnable example.

See #5549
Again, many thanks!  Are there any more before I fix and push this?