improved comments. simpler yet more verbose code

closed #41