hi moataz,
sorry for the late reply.
please note that recently there has been a lot of refactoring to improve readability in GIT by Ernesto Ferro, so if you looked at the code from the latest release, you probably want to look in GIT instead. more help to improve readability is always welcome in any case.
I guess it would be nice to have a short docstring here and there, perhaps even one for each module/class/method/function. perhaps you could try and write a few, so we can see what they would look like..? (preferrably in the form of a patch of course)
thanks!
mark.