added comments
added examples, split_up_a_sequence function