diff --git a/docs/installing-solidity.rst b/docs/installing-solidity.rst
index 4bdc284a9..8f30f1997 100644
--- a/docs/installing-solidity.rst
+++ b/docs/installing-solidity.rst
@@ -34,12 +34,12 @@ npm / Node.js
 
 Use `npm` for a convenient and portable way to install `solcjs`, a Solidity compiler. The
 `solcjs` program has less features than all options further down this page. Our 
-`Using the compiler <http://solidity.readthedocs.io/en/develop/using-the-compiler.html>`
-documentation assumes you are using the full-featured compiler, `solc`. So if you if you
-install `solcjs` from `npm` then you're on your own.
+`Using the compiler <using-the-compiler.html>` documentation assumes you are using
+the full-featured compiler, `solc`. So if you install `solcjs` from `npm` then you will
+stop reading the documentation here and then continue to <https://github.com/ethereum/solc-js>,
 
 Note: The `solc-js <https://github.com/ethereum/solc-js>` project is derived from the C++
-`solc` by using Emscripten. `solc-js` can be used in projects directly (such as Remix).
+`solc` by using Emscripten. `solc-js` can be used in JavaScript projects directly (such as Remix).
 Please refer to the `solc-js <https://github.com/ethereum/solc-js>`_ repository for instructions.
 
 .. code:: bash