Enhances comments, coding standards and readability

ok fair enough
I suppose coding style is going toward more object oriented extension of ElggObject now as opposed to just declaring a new subtype anyway.  All good :)