adds documentation to rotation_helpers.rb

## motivation

I remember writing this code in Lillehammer, Norway.  What a beautiful country.

## todo

- [ ] @krukow needs review

Merge at will.