add a contributing section

Author: rmorshea

docs/source/contributing.rst

@@ -0,0 +1,48 @@
+Contributing
+============
+
+.. note::
+
+    The
+    `Code of Conduct <https://github.com/idom-team/idom/blob/main/CODE_OF_CONDUCT.md>`__
+    applies in all community spaces. If you are not familiar with our Code of Conduct
+    policy, take a minute to read the policy before starting with your first contribution.
+
+The IDOM team welcomes contributions and contributors of all kinds - whether they come
+as code changes, participation in the discussions, opening issues and pointing out bugs,
+or simply sharing your work with your colleagues and friends. We're excited to see how
+you can help move this project and community forward!
+
+.. list-table::
+    :header-rows: 1
+
+    *   - I'm Looking For...
+        - Description
+
+    *   - `A discussion board <https://github.com/idom-team/idom/discussions>`__
+        - Ask questions, share ideas, or show projects
+
+    *   - `Where to report issues <https://github.com/idom-team/idom/issues>`__
+        - Tell us about any problems you're having
+
+    *   - `How to contribute Code <https://github.com/idom-team/idom/pulls>`__
+        - Make and review code changes
+
+    *   - `Other related projects <https://github.com/idom-team>`__
+        - Find other projects created by the IDOM team
+
+
+Everyone Can Contribute!
+------------------------
+
+Trust us, there's so many ways to help. We're always looking for people who can:
+
+- Improve our documentation
+- Teach and tell others about IDOM
+- Share ideas for new features
+- Report bugs
+- Participate in general discussions
+
+Still aren't sure how you can help? Just
+`ask us <https://github.com/idom-team/idom/discussions>`__ and we'll help you make your
+first contribution.

docs/source/developer-installation.rst

@@ -0,0 +1,101 @@
+Developer Installation
+======================
+
+In order to work with IDOM's source code you'll need to install:
+
+- git_
+
+- npm_
+
+You'll begin by copying the source from GitHub onto your computer using Git:
+
+.. code-block:: bash
+
+    git clone https://github.com/rmorshea/idom.git
+    cd idom
+
+At this point you should be able to run the command below to:
+
+- Install an editable version of the Python code
+
+- Download, build, and install Javascript dependencies
+
+- Install some pre-commit hooks for Git
+
+.. code-block:: bash
+
+    pip install -e . -r requirements.txt && pre-commit install
+
+Since we're using native ES modules for our Javascript, you should usually be able to
+refresh your browser page to see your latest changes to the client. However if you
+modify any dependencies you can run standard ``npm`` commands to install them or
+simply run the following to re-evaluate the ``package.json``:
+
+.. code-block:: bash
+
+    pip install -e .
+
+
+Running The Tests
+-----------------
+
+The test suite for IDOM is executed using Nox_ and covers:
+
+1. Server-side Python code with PyTest_
+
+2. The end-to-end application using Selenium_
+
+3. (`Coming soon <https://github.com/idom-team/idom/issues/195>`_) Client side Javascript code
+
+To run the full suite of tests you'll need to install:
+
+- `Google Chrome`_
+
+- ChromeDriver_.
+
+.. warning::
+
+    Be sure the version of `Google Chrome`_ and ChromeDriver_ you install are compatible.
+
+Once you've installed the aforementined browser and web driver you should be able to
+run:
+
+.. code-block:: bash
+
+    nox
+
+If you prefer to run the tests using a headless browser:
+
+.. code-block:: bash
+
+    HEADLESS=1 nox
+
+
+Building The Documentation
+--------------------------
+
+Building the documentation as it's deployed in production requires Docker_. Once you've
+installed ``docker`` you'll need to build and then run a container with the service:
+
+.. code-block:: bash
+
+    docker build . --file docs/Dockerfile --tag idom-docs:latest
+    docker run -it -p 5000:5000 -e DEBUG=true --rm idom-docs:latest
+
+You should then navigate to http://127.0.0.1:5000 to see the documentation.
+
+
+.. Links
+.. =====
+
+.. _Google Chrome: https://www.google.com/chrome/
+.. _ChromeDriver: https://chromedriver.chromium.org/downloads
+.. _Docker: https://docs.docker.com/get-docker/
+.. _git: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
+.. _Git Bash: https://gitforwindows.org/
+.. _npm: https://www.npmjs.com/get-npm
+.. _PyPI: https://pypi.org/project/idom
+.. _pip: https://pypi.org/project/pip/
+.. _PyTest: pytest <https://docs.pytest.org
+.. _Selenium: https://www.seleniumhq.org/
+.. _Nox: https://nox.thea.codes/en/stable/#

docs/source/extra-features.rst

@@ -6,33 +6,32 @@ Libraries for defining and controlling interactive webpages with Python
 
 .. toctree::
     :hidden:
-    :caption: User Guide
 
     installation
     getting-started
     life-cycle-hooks
     core-concepts
     javascript-components
-    specifications
-    extra-features
+
     examples
 
 .. toctree::
     :hidden:
-    :caption: Reference
+    :caption: Developer Guide
 
-    GitHub Repo <https://github.com/idom-team/idom>
+    contributing
+    developer-installation
+    specifications
     package-api
 
+.. toctree::
+    :hidden:
+    :caption: External Resources
 
-Early Days
-----------
-
-IDOM is still young. If you need help or want to contribute:
+    Source Code <https://github.com/idom-team/idom>
+    Community <https://github.com/idom-team/idom/discussions>
+    Issues <https://github.com/idom-team/idom/issues>
 
-- Ask `questions <https://github.com/idom-team/idom/discussions>`__
-- Report `issues <https://github.com/rmorshea/idom/issues>`__
-- Creating a `pull request <https://github.com/rmorshea/idom/pulls>`__
 
 
 At a Glance
@@ -46,8 +45,3 @@ user clicks an image:
 Try selecting the "Live Example" tab in the view above and enabling the widget.
 
 Once activated try clicking the displayed image to make it change 🖱️
-
-.. note::
-
-    You can display the same thing in a Jupyter Notebook by installing
-    `idom-jupyter <https://github.com/idom-team/idom-jupyter>`__.