docs($compile): update use cases for compile

It was brought up in #5638 that the current use cases for the compile definition field are out of date. These were the three use cases found in Angular's source for compile. 

The second use case apply's to situations that call for throwing errors during the compile phase. (ie... if required attributes are missing from the directive)