Updates documentation

I have started to fix documentation as I go through my first Ella project.
Sorry for the first commit which also contains a lot of whitespace cleanup as my SublimeText automatically strips ending whitespace. I will try to put whitespace cleanup to the separate commit next time.