Make doc structure more user friendly

Author: willingc

docs/source/conf.py

@@ -43,7 +43,7 @@
 
 master_doc = 'index'
 project = 'Jupyter Widgets'
-copyright = '2017 Project Jupyter'
+copyright = '2017-2021 Project Jupyter'
 author = 'Jupyter Team'
 
 language = None
@@ -103,4 +103,11 @@
 # -- Theme options -----------------
 
 # Options are theme-specific and customize the look and feel of the theme.
-html_theme_options = {}
+html_theme_options = {
+    # Toc options
+    'collapse_navigation': True,
+    'sticky_navigation': True,
+    'navigation_depth': 2,
+    'includehidden': True,
+    'titles_only': False
+}

docs/source/developer_docs.rst

@@ -1,5 +1,5 @@
-Developer Docs
-===============
+ipywidgets Development
+======================
 
 The Jupyter widgets packages are developed in the `https://github.com/jupyter-widgets/ipywidgets <https://github.com/jupyter-widgets/ipywidgets>`_ git repository. See the issue tracker, README, and other Github documents for the most recent information.
 
@@ -13,15 +13,3 @@ Scope of ipywidgets
 2. A basic, lightweight set of form controls that *use* this framework, based on standard HTML form controls. These included controls include a text area, text box, select and multiselect controls, checkbox, etc. A few more advanced controls that are very popular are also included, such as a slider and basic tab panels.
 
 The framework for building rich interactive objects is the foremost purpose of the ipywidgets project, and the set of included reference form controls is purposefully kept small and self-contained to serve as something like a reference implementation. We encourage and support a robust ecosystem of packages built on top of the ipywidgets framework to provide more complicated interactive objects, such as maps or 2d and 3d visualizations, or other form control systems built on a variety of popular Javascript frameworks such as Material or Vue.
-
-
-Additional Developer Docs
--------------------------
-
-.. toctree::
-   :maxdepth: 3
-
-   dev_install.md
-   dev_testing.md
-   dev_docs
-   dev_release.md

docs/source/index.rst

@@ -1,11 +1,48 @@
 ipywidgets
 ==========
 
-Full Table of Contents
-----------------------
+.. only:: html
+
+    :Release: |version|
+    :Date: |today|
 
 .. toctree::
-    :maxdepth: 2
+    :caption: User Guide
+    :maxdepth: 1
+
+    user_install.md
+    examples/Widget Basics.ipynb
+    examples/Widget List.ipynb
+    examples/Output Widget.ipynb
+    examples/Widget Events.ipynb
+    examples/Widget Styling.ipynb
+    examples/Layout Templates.ipynb
+    examples/Widget Custom.ipynb
+    examples/Using Interact.ipynb
+    examples/Widget Low Level.ipynb
+    examples/Widget Asynchronous.ipynb
+    embedding.md
+
+.. toctree::
+   :caption: Changelog and Migration
+   :maxdepth: 1
+
+   changelog.md
+   migration_guides.md
+
+.. toctree::
+   :caption: Developer Guide
+   :maxdepth: 1
+
+   developer_docs
+   dev_install.md
+   dev_testing.md
+   dev_docs
+   contributing.md
+   dev_release.md
+
+.. only:: html
 
-    user_guide
-    developer_docs
+  * :ref:`genindex`
+  * :ref:`modindex`
+  * :ref:`search`