diff --git a/CONTRIBUTING.txt b/CONTRIBUTING.txt
index aefde504..29dba55d 100644
--- a/CONTRIBUTING.txt
+++ b/CONTRIBUTING.txt
@@ -225,6 +225,73 @@ Every time Travis is triggered, it also calls on `Coveralls
 <http://coveralls.io>`_ to inspect the current test overage.
 
 
+Building docs
+-------------
+
+To build docs, run ``make`` from the ``docs`` directory. ``make help`` lists
+all targets.
+
+Requirements
+~~~~~~~~~~~~
+
+Sphinx (>= 1.3) and Latex is needed to build doc.
+
+**Sphinx:**
+
+.. code:: sh
+
+    pip install sphinx
+
+**Latex Ubuntu:**
+
+.. code:: sh
+
+    sudo apt-get install -qq texlive texlive-latex-extra dvipng
+
+**Latex Mac:**
+
+Install the full `MacTex <http://www.tug.org/mactex/>`__ installation or
+install the smaller
+`BasicTex <http://www.tug.org/mactex/morepackages.html>`__ and add *ucs*
+and *dvipng* packages:
+
+.. code:: sh
+
+    sudo tlmgr install ucs dvipng
+
+Fixing Warnings
+~~~~~~~~~~~~~~~
+
+-  "citation not found: R###" There is probably an underscore after a
+   reference in the first line of a docstring (e.g. [1]\_). Use this
+   method to find the source file: $ cd doc/build; grep -rin R####
+
+-  "Duplicate citation R###, other instance in..."" There is probably a
+   [2] without a [1] in one of the docstrings
+
+-  Make sure to use pre-sphinxification paths to images (not the
+   \_images directory)
+
+Auto-generating dev docs
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+This set of instructions was used to create
+scikit-image/tools/deploy-docs.sh
+
+-  Go to Github account settings -> personal access tokens
+-  Create a new token with access rights ``public_repo`` and
+   ``user:email only``
+-  Install the travis command line tool: ``gem install travis``. On OSX,
+   you can get gem via ``brew install ruby``.
+-  Take then token generated by Github and run
+   ``travis encrypt GH_TOKEN=<token>`` from inside a scikit-image repo
+-  Paste the output into the secure: field of ``.travis.yml``.
+-  The decrypted GH\_TOKEN env var will be available for travis scripts
+
+https://help.github.com/articles/creating-an-access-token-for-command-line-use/
+http://docs.travis-ci.com/user/encryption-keys/
+
+
 Bugs
 ----
 
diff --git a/doc/README.md b/doc/README.md
deleted file mode 100644
index d11b92dd..00000000
--- a/doc/README.md
+++ /dev/null
@@ -1,53 +0,0 @@
-# Building docs #
-To build docs, run `make` in this directory. `make help` lists all targets.
-
-## Requirements ##
-Sphinx (>= 1.3) and Latex is needed to build doc.
-
-**Sphinx:**
-```sh
-pip install sphinx
-```
-
-**Latex Ubuntu:**
-```sh
-sudo apt-get install -qq texlive texlive-latex-extra dvipng
-```
-
-**Latex Mac:**
-
-Install the full [MacTex](http://www.tug.org/mactex/) installation or install the smaller [BasicTex](http://www.tug.org/mactex/morepackages.html) and add *ucs* and *dvipng* packages:
-```sh
-sudo tlmgr install ucs dvipng
-```
-
-
-## Fixing Warnings ##
-
-- "citation not found: R###"
-  There is probably an underscore after a reference
-  in the first line of a docstring (e.g. [1]_).
-  Use this method to find the source file:
-  $ cd doc/build; grep -rin R####
-
-- "Duplicate citation R###, other instance in...""
-  There is probably a [2] without a [1] in one of
-  the docstrings
-
-- Make sure to use pre-sphinxification paths to images
-  (not the _images directory)
-
-
-## Auto-generating dev docs ##
-
-This set of instructions was used to create scikit-image/tools/deploy-docs.sh
-
-- Go to Github account settings -> personal access tokens
-- Create a new token with access rights `public_repo` and `user:email only`
-- Install the travis command line tool: `gem install travis`.  On OSX, you can get gem via `brew install ruby`.
-- Take then token generated by Github and run `travis encrypt GH_TOKEN=<token>` from inside a scikit-image repo
-- Paste the output into the secure: field of `.travis.yml`.
-- The decrypted GH_TOKEN env var will be available for travis scripts
-
-https://help.github.com/articles/creating-an-access-token-for-command-line-use/
-http://docs.travis-ci.com/user/encryption-keys/