Add comments (DocBlock)

Hi,

As promise, the "Docblock" part of pull-request #12 
My English is very basic, if you have remark about the documentation, it would be great !

Thanks for your work.
Best Regards
Why `= null`?