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.
Add explanation for the different values the scope property of the directive declaration can have.

Close #5761