added some docs to timespans