Update docs

Author: martinRenou

docs/conf.py

@@ -9,4 +9,4 @@
 master_doc = 'index'
 
 # General information about the project.
-project = 'test_docs'
+project = 'JupyterLite sphinx extension'

docs/index.rst

@@ -1,26 +1,30 @@
 jupyterlite-sphinx
 ==================
 
-JupyterLab:
------------
+Installation:
+-------------
 
-`JupyterLab <./lite/lab/index.html>`_
+You can install ``jupyterlite-sphinx`` with ``pip``:
 
-Retrolab:
----------
+.. code-block::
 
-`Retrolab <./lite/retro/index.html>`_
+    pip install jupyterlite-sphinx
 
-.. toctree::
-    :caption: Notebooks rendered with RetroLite:
-    :maxdepth: 2
+then you need to add the ``jupyterlite-sphinx`` extension to your ``conf.py`` file of your sphinx docs:
 
-    NotebookLite
+.. code-block:: python
+
+    extensions = [
+        'jupyterlite_sphinx',
+        # And other extensions
+        # ...
+    ]
 
 Replite directive:
 ------------------
 
-`jupyterlite-sphinx` provides a `replite` directive that allows you to embed a replite console in your docs:
+``jupyterlite-sphinx`` provides a ``replite`` directive that allows you to embed a replite console in your docs.
+This directive takes the same options as the ``replite`` package, see https://github.com/jtpio/replite for reference.
 
 .. code-block:: rst
 
@@ -41,3 +45,24 @@ Replite directive:
    :height: 600px
 
     print('Hello, World!')
+
+Retrolite directive:
+--------------------
+
+``jupyterlite-sphinx`` provides a ``retrolite`` directive that allows you to embed an entire executable Notebook in your docs.
+It takes the name of the Notebook as argument:
+
+.. code-block:: rst
+
+    .. retrolite:: my_notebook.ipynb
+
+.. retrolite:: my_notebook.ipynb
+
+JupyterLab and RetroLab deployed for you:
+-----------------------------------------
+
+``jupyterlite-sphinx`` makes a full deployment of JupyterLite for you, you can access the JupyterLab UI and RetroLab UI following the
+``./lite/lab/index.html`` and ``./lite/retro/index.html`` relative URLs:
+
+`JupyterLab <./lite/lab/index.html>`_
+`Retrolab <./lite/retro/index.html>`_