Finish initial docs

Author: vidartf

docs/source/develop-install.rst

@@ -0,0 +1,32 @@
+
+Developer install
+=================
+
+
+To install a developer version of pythreejs, you will first need to clone
+the repository::
+
+    git clone https://github.com/jovyan/pythreejs
+    cd pythreejs
+
+Next, install it with a develop install using pip::
+
+    pip install -e .
+
+
+If you are not planning on working on the JS/frontend code, you can
+simply install the extensions as you would for a :ref:`normal install<installation>`.
+For a JS develop install, you should link your extensions::
+
+    jupyter nbextension install [--sys-prefix / --user / --system] --symlink --py pythreejs
+
+    jupyter nbextension enable [--sys-prefix / --user / --system] --py pythreejs
+
+with the `appropriate flag`_. Or, if you are using Jupyterlab::
+
+    jupyter labextension link ./js
+
+
+.. links
+
+.. _`appropriate flag`: https://jupyter-notebook.readthedocs.io/en/stable/extending/frontend_extensions.html#Installing-and-enabling-extensions

docs/source/installing.rst

@@ -0,0 +1,37 @@
+
+.. _installation:
+
+Installation
+============
+
+
+The simplest way to install pythreejs is via pip::
+
+    pip install pythreejs
+
+or via conda::
+
+    conda install pythreejs
+
+
+If you installed via pip, you will also have to install / configure the
+front-end extension as well. If you are using classic notebook (as opposed to
+Jupyterlab), run::
+
+    jupyter nbextension install [--sys-prefix / --user / --system] --py pythreejs
+
+    jupyter nbextension enable [--sys-prefix / --user / --system] --py pythreejs
+
+with the `appropriate flag`_. If you are using Jupyterlab, install the extension
+with::
+
+    jupyter labextension install jupyter-threejs
+
+If you are installing using conda, these commands should be unnecessary, but If
+you need to run them the commands should be the same (just make sure you choose the
+`--sys-prefix` flag).
+
+
+.. links
+
+.. _`appropriate flag`: https://jupyter-notebook.readthedocs.io/en/stable/extending/frontend_extensions.html#Installing-and-enabling-extensions

docs/source/introduction.rst

@@ -17,12 +17,13 @@ Renderer classes
 While the :py:class:`~pythreejs.WebGLRenderer` class mimics its three.js
 counterpart in only rendering frames on demand (one frame per call to its
 :py:meth:`~pythreejs.WebGLRenderer.render` method), the :py:class:`~pythreejs.Renderer` class
-sets up an interactive render loop allowing for `interactive controls`_ and `animation`_.
+sets up an interactive render loop allowing for
+:ref:`interactive_controls` and :ref:`animation`.
 Similarly, a :py:class:`~pythreejs.Preview` widget allows for a quick visualization of various
 threejs objects.
 
 
-.. _interactive controls:
+.. _interactive_controls:
 
 Interactive controls
 --------------------