CHG: helper function implemented as generator, docstrings

1 job for master in 22 seconds (queued for 2 seconds)
Status Name Job ID Coverage
  Build
passed build #304159

00:00:22