[doc] move the documentations from docstring directly to the book.
and improve a bit API documentations.
Related to #4832808
Document: cubicweb-doc
Title: CubicWeb documentation
Author: Logilab
Abstract: Some base documentation for CubicWeb users and developpers
Section: Apps/Programming
Format: HTML
Index: /usr/share/doc/cubicweb-documentation/index.html
Files: /usr/share/doc/cubicweb-documentation/*.html