Write proper documentation for the project

[shaief]

note to self:

I guess it's a self explanatory, but still -

We need to write good documentation to any piece of code that we write. That includes, but not limited to:
modules, classes, functions and general things like a good readme.