docs($compile): improve documentation on directive $scope usage

Add information about the behavior of several directives especially of their scopes when applied on a single element.

Close #5761
Yeah I also browsed this part of the angular code, but you're right, my changes didn't really improve the documentation here. I'll rewrite this part so it hopefully becomes more clear then.