use instance_doubles
streamline docs
changelog for #1510