further simplified docs
showing how period is used