TODO doc updated

with clock up documentation for determining when period starts