Adding more about the --failed functionality

@jzoldak and @dmitchell 

Referencing issue TE-338