final version
readme added
comments where possible