[doc] move the documentations from docstring directly to the book. and improve a bit API documentations. Related to #4832808

missing-dep-for-interpreter make => make | build-essential | dpkg-dev (usr/*/cubicweb/skeleton/debian/rules.tmpl)