cut down the dev description, link to the Jupyter Guides

Author: rolweber

README.md

@@ -14,73 +14,31 @@ for installing kernelspecs for use with Jupyter frontends.
 
 # Development Setup
 
-To develop and contribute code for the Jupyter Client, you should set up
-a development environment to run the test suite and build the documentation.
-The following steps assume that you have `git`, `python`, `pip`, and `make`
-already installed and on the system search path.
-You might want to set up the development project in a dedicated
-[virtual environment](https://virtualenv.pypa.io/en/stable/) or
-[conda environment](https://conda.io/docs/using/envs.html),
-depending on what Python distribution you are using.
-
-## Clone the Repository
-
-Fetch the Jupyter Client source code by cloning the GitHub repository itself,
-or your [fork](https://help.github.com/articles/fork-a-repo/) of it.
-To clone the original repository into a subdirectory `jupyter_client` of
-`/my/projects/`:
-
-    cd /my/projects/
-    git clone https://github.com/jupyter/jupyter_client.git
-
-If you have configured an SSH key pair for GitHub authentication, use the
-[SSH URL](https://help.github.com/articles/which-remote-url-should-i-use/)
-for cloning instead. But then you already know how to do that anyway.
-
-## Install the Dependencies
-
-The Jupyter Client code depends on several other Python packages at runtime.
-The test suite requires a few more packages on top of that.
-An [editable install](https://pip.pypa.io/en/stable/reference/pip_install/#editable-installs)
-with `pip` will download the dependencies, and add your local clone of the
-Jupyter Client to the Python environment. To create the editable install and
-include the dependencies for the test suite:
+The [Jupyter Contributor Guides](http://jupyter.readthedocs.io/en/latest/contributor/content-contributor.html) provide extensive information on contributing code or documentation to Jupyter projects. The limited instructions below for setting up a development environment are for your convenience.
 
-    cd /my/projects/jupyter_client/
-    pip install -e .[test]
-
-The Jupyter Client documentation is built with
-[Sphinx](http://www.sphinx-doc.org/en/stable/).
-You can install that with `pip` or,
-if you are using an Anaconda distribution, with `conda`.
-
-    # in a virtual environment...
-    pip install sphinx sphinx_rtd_theme
+## Coding
 
-    # in a conda environment...
-    conda install sphinx sphinx_rtd_theme
-
-## Run the Test Suite
-
-Use `py.test` to run the test suite:
+You'll need Python and `pip` on the search path. Clone the Jupyter Client git repository to your computer, for example in `/my/project/jupyter_client`.
+Now create an [editable install](https://pip.pypa.io/en/stable/reference/pip_install/#editable-installs)
+and download the dependencies of code and test suite by executing:
 
     cd /my/projects/jupyter_client/
+    pip install -e .[test]
     py.test
 
-The full test suite takes a while. During development, you'll probably prefer
-to run only the tests relevant to your changes. You can tell `py.test` to
-run just the tests from a single file by providing the path to the file.
-For example:
+The last command runs the test suite to verify the setup. During development, you can pass filenames to `py.test`, and it will execute only those tests.
 
-    cd /my/projects/jupyter_client
-    py.test jupyter_client/tests/test_session.py
+## Documentation
 
-## Build the Documentation
+The documentation of Jupyter Client is generated from the files in `docs/` using Sphinx. Instructions for setting up Sphinx with a selection of optional modules are in the [Documentation Guide](http://jupyter.readthedocs.io/en/latest/contrib_docs/index.html). You'll also need the `make` command.
+For a minimal Sphinx installation to process the Jupyter Client docs, execute:
+
+    pip install sphinx sphinx_rtd_theme
 
-Use `make` to build the documentation in HTML:
+The following commands build the documentation in HTML format and check for broken links:
 
     cd /my/projects/jupyter_client/docs/
-    make html
+    make html linkcheck
 
 Point your browser to the following URL to access the generated documentation: