a bit of documentation
move helpers to spec_helper