add timespan and more docs