[doc] move the documentations from docstring directly to the book.
and improve a bit API documentations.
Related to #4832808
# -*- coding: utf-8 -*-
# copyright %(year)s %(author)s, all rights reserved.
# contact %(author-web-site)s -- mailto:%(author-email)s
#
%(long-license)s
"""%(distname)s entity's classes"""