Cleaned up text

Hi Pawel,

I've edited this - it is still pretty sparse - if there are parts of the code you want to explain that might be useful?