added docs
added time warning