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 was incorrect before --- but it's still incorrect here =) we actually throw (except possibly under a few corner cases, which are bugs)