update period documentation