enhance documentation

- flatten hierarchy (some links do not work when using folders)
+ fix a bug with the redorder flag in Override
+ allow removal of parameters
+ clean description using inspect.cleandoc

Change-Id: I3dde4f4cb29c46e8a21014f1fad7aa3ad610a1bf

doc/source/_static/custom.css

@@ -1,9 +1,10 @@
-/* this is for the sphinx_rtd_theme
+/* this is for the sphinx_rtd_theme */
 div.wy-nav-content
 {
 	    max-width: 100% !important;
 }
-*/
+
+/* this is for the alabaser theme */
 div.body {
     max-width: 100%;
 }
@@ -32,4 +33,19 @@ pre, tt, code {
     }
 }
 
+dd {
+    padding-bottom: 0.5em;
+}
+
+/* make nested bullet lists nicer (ales too much space above inner nested list) */
+.rst-content .section ul li ul {
+    margin-top: 0px;
+    margin-bottom: 6px;
+}
+
+/* make some bullet lists more dense (this rule exists in theme.css, but not important)*/
+.wy-plain-list-disc li p:last-child, .rst-content .section ul li p:last-child, .rst-content .toctree-wrapper ul li p:last-child, article ul li p:last-child {
+   margin-bottom: 0 !important;
+}
+