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
typo: 'will be called'