fixes typo for yield
adds documentation
fresh? should return true if it does not return a stale element