Merge pull request grpc#203 from LisaFC/overviewupdate

Updated installation instructions

Author: hsaliak

docs/index.md

@@ -342,13 +342,10 @@ To install protocol buffers support (the protocol buffer compiler and the protoc
 If you <a href="https://github.com/grpc/grpc/blob/{{ site.data.config.grpc_release_branch }}/INSTALL.md">build and install gRPC from source</a>, the Makefile will automatically install <code>protoc</code> as well (if you don't already have it installed). Installing gRPC also gets you the gRPC C++ plugin for <code>protoc</code>.
 </div>
 <div id="python_protoc">
-First <a href="https://github.com/google/protobuf/blob/master/README.md">install <code>protoc</code></a> from its Github repository. Then build and install the gRPC plugin:
+On Mac, Linux, and Windows, run:
 
 <pre>
-git clone https://github.com/grpc/grpc.git $REPO
-cd $REPO
-make grpc_python_plugin
-cp bins/opt/grpc_python_plugin $SOMEWHERE_ON_PATH
+pip install grpcio-tools
 </pre>
 </div>
 <div id="go_protoc">
@@ -359,17 +356,17 @@ $ go get -a github.com/golang/protobuf/protoc-gen-go
 </pre>
 </div>
 <div id="ruby_protoc">
-First <a href="https://github.com/google/protobuf/blob/master/README.md">install <code>protoc</code></a> from its Github repository. Then build and install the gRPC plugin:
+On Mac, Linux, and Windows, run:
 
 <pre>
-git clone https://github.com/grpc/grpc.git $REPO
-cd $REPO
-make grpc_ruby_plugin
-cp bins/opt/grpc_ruby_plugin $SOMEWHERE_ON_PATH
+gem install grpc-tools
 </pre>
 </div>
 <div id="node_protoc">
-The Node.js gRPC library currently dynamically generates the necessary gRPC code at runtime, so you don't need to install a protocol buffer compiler yourself.
+The Node.js gRPC library can either dynamically generate the necessary gRPC code at runtime or you can use the protocol buffer code generated by <code>protoc</code>. In our example we're going to use dynamic code generation, so if you want to follow along you don't need to have the protocol buffer compiler installed. If you do want to use statically generated code, you can install the compiler by running:
+<pre>
+npm install grpc-tools
+</pre>
 </div>
 <div id="csharp_protoc">
 Install the <a href="https://www.nuget.org/packages/Google.Protobuf">Google.Protobuf</a> and <a href="https://www.nuget.org/packages/Grpc.Tools">Grpc.Tools</a> NuGet packages from your IDE (Visual Studio, Xamarin Studio or Monodevelop).
@@ -378,7 +375,7 @@ Install the <a href="https://www.nuget.org/packages/Google.Protobuf">Google.Prot
 Follow the instructions in <a href="https://github.com/grpc/grpc/tree/master/src/objective-c">gRPC for Objective C</a> to install <code>protoc</code> and the appropriate plugin. Instructions are provided for installation with and without Homebrew.
 </div>
 <div id="php_protoc">
-First <a href="https://github.com/google/protobuf/blob/master/README.md">install <code>protoc</code></a> from its Github repository. Then install the third-party <code>protoc-gen-php</code> plugin.
+First <a href="https://github.com/google/protobuf/blob/master/README.md">install <code>protoc</code></a> from its Github repository. Then install the <a href="https://github.com/stanley-cheung/protobuf-php">third-party <code>protoc-gen-php</code> plugin</a>.
 </div>
 </div>
 
@@ -765,7 +762,7 @@ message, as specified in our interface definition, then return.</p>
 
   </div>
   <div id="node_service">
-<p><a href="https://github.com/grpc/grpc/blob/{{ site.data.config.grpc_release_branch }}/examples/node/greeter_server.js">greeter&lowbar;server.js</a> implements our <code>Greeter</code> service's required behaviour.
+<p><a href="https://github.com/grpc/grpc/blob/{{ site.data.config.grpc_release_branch }}/examples/node/dynamic_codegen/greeter_server.js">greeter&lowbar;server.js</a> implements our <code>Greeter</code> service's required behaviour.
 <p>Our server implements the <code>Greeter</code>service from our
 service definition by implementing the method <code>SayHello</code>:</p>
 <pre>
@@ -904,7 +901,7 @@ end
 
   </div>
   <div id="node_server">
-<p><a href="https://github.com/grpc/grpc/blob/{{ site.data.config.grpc_release_branch }}/examples/node/greeter_server.js">greeter&lowbar;server.js</a> also provides this for our Node.js example.
+<p><a href="https://github.com/grpc/grpc/blob/{{ site.data.config.grpc_release_branch }}/examples/node/dynamic_codegen/greeter_server.js">greeter&lowbar;server.js</a> also provides this for our Node.js example.
 <pre>
 function main() {
   var server = new Server({
@@ -1147,7 +1144,7 @@ log.Printf("Greeting: %s", r.Message)</pre>
 <pre>  client.sayHello({name: user}, function(err, response) {
     console.log('Greeting:', response.message);
   });</pre>
-<p>You can see the complete client code in <a href="https://github.com/grpc/grpc/blob/{{ site.data.config.grpc_release_branch }}/examples/node/greeter_client.js">greeter_client.js</a>.</p>
+<p>You can see the complete client code in <a href="https://github.com/grpc/grpc/blob/{{ site.data.config.grpc_release_branch }}/examples/node/dynamic_codegen/greeter_client.js">greeter_client.js</a>.</p>
 
   </div>
   <div id="csharp_call">
@@ -1233,7 +1230,7 @@ Then run the server, which will listen on port 50051:
 
   </div>
   <div id="node_runserver">
-<p>You can run the server from <code>examples/node</code> using:
+<p>You can run the server from <code>examples/node/dynamic&#95;codegen</code> using:
 <pre>$ node ./greeter_server.js &</pre>
 
   </div>
@@ -1297,7 +1294,7 @@ Then run the client:
 
   </div>
   <div id="node_runclient">
-<p>You can run the client from <code>examples/node</code> using:
+<p>You can run the client from <code>examples/node/dynamic&#95;codegen</code> using:
 <pre>$ node ./greeter_client.js</pre>
 
 </div>