use javadoc & improve documentation

I think the team should use javadoc,
i hate it when i have to open the documentation website only for checking what method does and what exactly the parameters are.
And also your documentation is not good.
thank you!