docs($compile): add note about recursive compilation in templates

I am not sure the explanation is clear, but I think it's something that should be noted.

Closes https://github.com/angular/angular.js/issues/3079