loading indicator module added

+ more documentation
+ code cleanup