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
this implies that `false` is somehow different from any other non-`true`, non-object value. The only cases that matter are `true` and `object`