Repository: napari/napari

Issue:
Hosted docs
## 📚 Documentation

I think now would be a good time for us to start hosting our API docs on a public site. I view this as complimentary to, but connected to our current [tutorials page](https://napari.github.io/napari-tutorials/)

Using readthedocs is fine with me, I don't know if CZI will pay to remove adds, but that would be reasonable. Alternatively there is https://github.com/freeman-lab/minidocs made by our very own @freeman-lab or direct integration with our tutorials page.

Thoughts @kne42 @AhmetCanSolak @jni? 


Discussion:
There was a recent [discussion around hosted docs on twitter](https://twitter.com/choldgraf/status/1158848109465624576) that might be of interest too.
I use [doctr](https://github.com/drdoctr/doctr) for the skan docs and really like it:

https://jni.github.io/skan/

That would be my recommendation. The only thing I haven't set up yet is multiple hosted versions, but I think that's not hard to do.
`doctr` looks super awesome but unfortunately we do not use travis, although i suppose we could set it up for this purpose. i am definitely in favor of self-hosting our docs if possible :)

it's also not terribly difficult to replicate this functionality ourselves, see [how scikit-image does it](https://github.com/scikit-image/scikit-image/blob/master/tools/travis/deploy_docs.sh)

since there are a number of issues with our docs' formatting and content, i would advise focusing on that prior to hosting them

sidenote: @jni are you the one who owns napari.org? we'll need your help to properly set up the GH pages on that domain :)
@kne42 Is Doctr really travis only? Could we not adapt it to other CIs? And anyway, as you mention, we can have Travis just for docs, I don't think that's a big deal.

Yes I own napari.org, happy to change that to our gh-pages site once it's up and running!
@jni Yes, I inspected the code and it's only compatible with travis due to its reliance on its environment variables. We may define these in our config as a hack but that's not guaranteed to work.

Resolving patch:
diff --git a/docs/source/conf.py b/docs/conf.py
similarity index 98%
rename from docs/source/conf.py
rename to docs/conf.py
--- a/docs/source/conf.py
+++ b/docs/conf.py
@@ -67,7 +67,7 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+exclude_patterns = ['Thumbs.db', '.DS_Store']
 
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = None


Test patch:
diff --git a/docs/source/napari.components._dims.tests.rst b/docs/source/napari.components._dims.tests.rst
deleted file mode 100644
--- a/docs/source/napari.components._dims.tests.rst
+++ /dev/null
@@ -1,22 +0,0 @@
-napari.components.\_dims.tests package
-======================================
-
-Submodules
-----------
-
-napari.components.\_dims.tests.dims\_tests module
--------------------------------------------------
-
-.. automodule:: napari.components._dims.tests.dims_tests
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-
-Module contents
----------------
-
-.. automodule:: napari.components._dims.tests
-   :members:
-   :undoc-members:
-   :show-inheritance:
diff --git a/docs/source/napari.components._layers_list.tests.rst b/docs/source/napari.components._layers_list.tests.rst
deleted file mode 100644
--- a/docs/source/napari.components._layers_list.tests.rst
+++ /dev/null
@@ -1,22 +0,0 @@
-napari.components.\_layers\_list.tests package
-==============================================
-
-Submodules
-----------
-
-napari.components.\_layers\_list.tests.layers\_list\_tests module
------------------------------------------------------------------
-
-.. automodule:: napari.components._layers_list.tests.layers_list_tests
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-
-Module contents
----------------
-
-.. automodule:: napari.components._layers_list.tests
-   :members:
-   :undoc-members:
-   :show-inheritance:
diff --git a/docs/source/napari.util.tests.rst b/docs/source/napari.util.tests.rst
deleted file mode 100644
--- a/docs/source/napari.util.tests.rst
+++ /dev/null
@@ -1,30 +0,0 @@
-napari.util.tests package
-=========================
-
-Submodules
-----------
-
-napari.util.tests.test\_misc module
------------------------------------
-
-.. automodule:: napari.util.tests.test_misc
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-napari.util.tests.test\_naming module
--------------------------------------
-
-.. automodule:: napari.util.tests.test_naming
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-
-Module contents
----------------
-
-.. automodule:: napari.util.tests
-   :members:
-   :undoc-members:
-   :show-inheritance: