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
https://github.com/angular/angular.js/blob/master/src/ng/compile.js#L1546 for reference