Extend docs (#1309)

* re-structure manual and use 'collapse'

* ADD link to auto-sklearn-talks

* unifying titles

* Clarify default memory and cpu usage

* FIX sphinx_gallery to <=0.10.0

0.10.1 would raise an error for '-D plot_gallery=0'

* Re-structure faq

* FIX comments by mfeurer

* boldface items

* merge manual into FAQ

* FIX minor

* FIX typo

* Update doc/faq.rst

Co-authored-by: Eddie Bergman <[email protected]>

* Update doc/faq.rst

Co-authored-by: Eddie Bergman <[email protected]>

* Update doc/faq.rst

Co-authored-by: Eddie Bergman <[email protected]>

* Update doc/faq.rst

Co-authored-by: Eddie Bergman <[email protected]>

* Update doc/manual.rst

Co-authored-by: Eddie Bergman <[email protected]>

* Update doc/manual.rst

Co-authored-by: Eddie Bergman <[email protected]>

* Update doc/faq.rst

Co-authored-by: Eddie Bergman <[email protected]>

* FIX link

Co-authored-by: Eddie Bergman <[email protected]>

Author: KEggensperger

autosklearn/estimators.py

@@ -97,6 +97,13 @@ def __init__(
             Memory limit in MB for the machine learning algorithm.
             `auto-sklearn` will stop fitting the machine learning algorithm if
             it tries to allocate more than ``memory_limit`` MB.
+            
+            **Important notes:** 
+            
+            * If ``None`` is provided, no memory limit is set.
+            * In case of multi-processing, ``memory_limit`` will be *per job*, so the total usage is 
+              ``n_jobs x memory_limit``.
+            * The memory limit also applies to the ensemble creation process.
 
             **Important notes:**
 

doc/conf.py

@@ -198,7 +198,7 @@
         ('Start', 'index'),
         ('Releases', 'releases'),
         ('Installation', 'installation'),
-        ('Manual', 'manual'),
+        #('Manual', 'manual'),
         ('Examples', 'examples/index'),
         ('API', 'api'),
         ('Extending', 'extending'),

setup.py

@@ -41,12 +41,11 @@
         "seaborn",
     ],
     "docs": [
-        "sphinx<4.3",
-        "sphinx-gallery",
+        "sphinx",
+        "sphinx-gallery<=0.10.0",
         "sphinx_bootstrap_theme",
         "numpydoc",
         "sphinx_toolbox",
-        "docutils==0.16"
     ],
 }