[doc]: detailed doc of the public classes