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
incorrect --- if `scope` is an object (but not `true`), it will still create a new scope.