updated comments in prep for refactor / upgrade

We want to start using a Gene class in order to support choosing which
direction we travel in time.