period tests, a bit of documentation