added PHPDOC comments

Started documenting the class and all its properties and methods...
Still a WiP.