minor doc updates

Author: rmorshea

docs/source/extra-features.rst

@@ -1,35 +1,45 @@
 Extra Features
 ==============
 
-Optionally installable features of IDOM.
+Optionally installable features of IDOM. To install them use the given "Name" from the table below
 
-To install a **stable** set of features for IDOM simply run.
+.. code-block:: bash
 
-.. code-block::
+    pip install idom[NAME]
 
-    pip install idom[stable]
+.. list-table::
+    :header-rows: 1
+    :widths: 1 3
 
-To install **all** extra features run
+    *   - Name
+        - Description
 
-.. code-block::
+    *   - ``stable``
+        - Default implementations for all IDOM's features
+
+    *   - ``testing``
+        - Utilities for testing IDOM using `Selenium <https://www.selenium.dev/>`__
 
-    pip install idom[all]
+    *   - ``sanic``
+        - `Sanic <https://sanicframework.org/>`__ as a :ref:`Layout Server`
 
+    *   - ``tornado``
+        - `Tornado <https://www.tornadoweb.org/en/stable/>`__ as a :ref:`Layout Server`
 
-Layout Server Implementations
------------------------------
+    *   - ``flask``
+        - `Flask <https://palletsprojects.com/p/flask/>`__ as a :ref:`Layout Server`
 
-There are several supported :ref:`Layout Server` implementations available for IDOM:
+    *   - ``dialect``
+        - :ref:`Python Language Extension` for writing JSX-like syntax
 
-- `Sanic <https://sanicframework.org/>`__: ``pip install idom[sanic]``
-- `Flask <https://palletsprojects.com/p/flask/>`__: ``pip install idom[flask]``
-- `Tornado <https://www.tornadoweb.org/en/stable/>`__: ``pip install idom[tornado]``
+    *   - ``all``
+        - All the features listed above (not usually needed)
 
 
 Python Language Extension
 -------------------------
 
-IDOM includes a transpiler for writing JSX-like syntax in a normal Python file!
+IDOM includes an import-time transpiler for writing JSX-like syntax in a ``.py`` file!
 
 .. code-block:: python
 

docs/source/index.rst

@@ -13,6 +13,8 @@ Libraries for defining and controlling interactive webpages with Python
     life-cycle-hooks
     core-concepts
     javascript-components
+    specifications
+    extra-features
     examples
 
 .. toctree::
@@ -21,8 +23,6 @@ Libraries for defining and controlling interactive webpages with Python
 
     GitHub Repo <https://github.com/idom-team/idom>
     package-api
-    specifications
-    extra-features
 
 
 Early Days

docs/source/installation.rst

@@ -1,34 +1,19 @@
 Installation
 ============
 
-.. list-table::
-    :header-rows: 1
+To install IDOM and a default implementation for all features:
 
-    *   - What
-        - How To Install
-
-    *   - The Core Library
-        - IDOM is on PyPI_ - use  pip_ to install a **stable** version:
-
-          .. code-block:: bash
-
-              pip install idom[stable]
-
-    *   - Extra Features
-
-        - To install **specific** features see :ref:`Extra Features`, but to install all of them:
+.. code-block:: bash
 
-          .. code-block:: bash
+    pip install idom[stable]
 
-              # all extra features
-              pip install idom[all]
+For a minimal installation that lacks implementations for some features:
 
-    *   - Pre Release
-        - This may be unstable or subject to breaking changes
+.. code-block:: bash
 
-          .. code-block:: bash
+    pip install idom
 
-              pip install idom --pre
+For more installation options see the :ref:`Extra Features` section.
 
 
 Development Version