docs: use period() in period's examples

[eitsupi]

Given the context, period() seems appropriate, not duration().

[vspinu]

Thanks!