Merge pull request #719 from carl-mastrangelo/taggy

Use gRPC tags rather than branches in docs

Author: carl-mastrangelo

_data/config.yml

@@ -1,3 +1,3 @@
-grpc_release_branch: v1.14.x
+grpc_release_tag: v1.14.0
 grpc_java_release_tag: v1.14.0
 milestones_link: https://github.com/grpc/grpc/milestones

_includes/c-lang-list.html

@@ -1,8 +1,8 @@
 <a href="https://github.com/grpc/grpc">C</a>, 
-<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_branch }}/src/cpp">C++</a>, 
-<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_branch }}/src/node">Node.js</a>, 
-<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_branch }}/src/python">Python</a>, 
-<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_branch }}/src/ruby">Ruby</a>, 
-<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_branch }}/src/objective-c">Objective-C</a>, 
-<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_branch }}/src/php">PHP</a> and 
-<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_branch }}/src/csharp">C#</a>.
+<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_tag }}/src/cpp">C++</a>, 
+<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_tag }}/src/node">Node.js</a>, 
+<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_tag }}/src/python">Python</a>, 
+<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_tag }}/src/ruby">Ruby</a>, 
+<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_tag }}/src/objective-c">Objective-C</a>, 
+<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_tag }}/src/php">PHP</a> and 
+<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_tag }}/src/csharp">C#</a>.

_includes/lang-list.html

@@ -1,11 +1,11 @@
 <a href="https://github.com/grpc/grpc">C</a>, 
-<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_branch }}/src/cpp">C++</a>,
-<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_branch }}/src/csharp">C#</a>,
+<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_tag }}/src/cpp">C++</a>,
+<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_tag }}/src/csharp">C#</a>,
 <a href="https://github.com/grpc/grpc-dart">Dart</a>,
 <a href="https://github.com/grpc/grpc-go">Go</a>,
 <a href="https://github.com/grpc/grpc-java">Java</a>,
-<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_branch }}/src/node">Node.js</a>,
-<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_branch }}/src/objective-c">Objective-C</a>,
-<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_branch }}/src/php">PHP</a>,
-<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_branch }}/src/python/grpcio">Python</a>, and
-<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_branch }}/src/ruby">Ruby</a>.
+<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_tag }}/src/node">Node.js</a>,
+<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_tag }}/src/objective-c">Objective-C</a>,
+<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_tag }}/src/php">PHP</a>,
+<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_tag }}/src/python/grpcio">Python</a>, and
+<a href="https://github.com/grpc/grpc/tree/{{ site.data.config.grpc_release_tag }}/src/ruby">Ruby</a>.

_posts/2016-4-4-installation.md

@@ -32,7 +32,7 @@ Go | Linux, Mac, Windows | `go get google.golang.org/grpc`
 Objective-C | Mac | Runtime source fetched automatically from Github by Cocoapods
 C# | Windows | Install [gRPC NuGet package](https://www.nuget.org/packages/Grpc/) from your IDE (Visual Studio, Monodevelop, Xamarin Studio)
 Java | Linux, Mac, Windows | Use our [Maven and Gradle plugins](https://github.com/grpc/grpc-java/blob/master/README.md) that provide gRPC with [statically linked `boringssl`](https://github.com/grpc/grpc-java/blob/master/SECURITY.md#openssl-statically-linked-netty-tcnative-boringssl-static)
-C++ | Linux, Mac, Windows | Currently requires [manual build and install](https://github.com/grpc/grpc/blob/{{ site.data.config.grpc_release_branch }}/INSTALL.md)
+C++ | Linux, Mac, Windows | Currently requires [manual build and install](https://github.com/grpc/grpc/blob/{{ site.data.config.grpc_release_tag }}/INSTALL.md)
 
 You can find out more about installation in our [Getting Started guide](/docs/#install-grpc) and Github repositories. Do send us your feedback on our [mailing list](https://groups.google.com/forum/#!forum/grpc-io) or file issues on our issue tracker if you run into any problems.
 

docs/quickstart/csharp.md

@@ -55,7 +55,7 @@ and other tutorials):
 
 ```sh
 $ # Clone the repository to get the example code:
-$ git clone -b {{ site.data.config.grpc_release_branch }} https://github.com/grpc/grpc 
+$ git clone -b {{ site.data.config.grpc_release_tag }} https://github.com/grpc/grpc 
 $ cd grpc
 ```
 
@@ -212,7 +212,7 @@ The `Grpc.Tools` NuGet package contains the protoc and protobuf C# plugin binari
 
 #### Using Visual Studio
 
-This example project already depends on the `Grpc.Tools.{{ site.data.config.grpc_release_branch | remove_first: "v" }}` NuGet package, so it should be included in `examples/csharp/helloworld/packages` when the `Greeter.sln` solution is built from your IDE, 
+This example project already depends on the `Grpc.Tools.{{ site.data.config.grpc_release_tag | remove_first: "v" }}` NuGet package, so it should be included in `examples/csharp/helloworld/packages` when the `Greeter.sln` solution is built from your IDE, 
 or when you restore packages via `/path/to/nuget restore` on the command line.
 
 #### If you have a NuGet client that is __not__ at version 2.12
@@ -230,8 +230,8 @@ is by simply downloading the NuGet package and unzipping without a NuGet client,
 From your example directory:
 
 ```
-$ temp_dir=packages/Grpc.Tools.{{ site.data.config.grpc_release_branch | remove_first: "v" }}/tmp
-$ curl_url=https://www.nuget.org/api/v2/package/Grpc.Tools/{{ Grpc.Tools.{{ site.data.config.grpc_release_branch | remove_first: "v" }}
+$ temp_dir=packages/Grpc.Tools.{{ site.data.config.grpc_release_tag | remove_first: "v" }}/tmp
+$ curl_url=https://www.nuget.org/api/v2/package/Grpc.Tools/{{ Grpc.Tools.{{ site.data.config.grpc_release_tag | remove_first: "v" }}
 $ mkdir -p $temp_dir && cd $temp_dir && curl -sL $curl_url > tmp.zip; unzip tmp.zip && cd .. && cp -r tmp/tools . && rm -rf tmp && cd ../..
 ```
 
@@ -247,13 +247,13 @@ From the `examples/csharp/helloworld` directory, or the `examples/csharp/hellowo
 **Windows**
 
 ```
-> packages\Grpc.Tools.{{ site.data.config.grpc_release_branch | remove_first: "v" }}\tools\windows_x86\protoc.exe -I../../protos --csharp_out Greeter --grpc_out Greeter ../../protos/helloworld.proto --plugin=protoc-gen-grpc=packages/Grpc.Tools.{{ site.data.config.grpc_release_branch | remove_first: "v" }}/tools/windows_x86/grpc_csharp_plugin.exe
+> packages\Grpc.Tools.{{ site.data.config.grpc_release_tag | remove_first: "v" }}\tools\windows_x86\protoc.exe -I../../protos --csharp_out Greeter --grpc_out Greeter ../../protos/helloworld.proto --plugin=protoc-gen-grpc=packages/Grpc.Tools.{{ site.data.config.grpc_release_tag | remove_first: "v" }}/tools/windows_x86/grpc_csharp_plugin.exe
 ```
 
 **Linux (or OS X by using macosx_x64 directory)**
 
 ```
-$ packages/Grpc.Tools.{{ site.data.config.grpc_release_branch | remove_first: "v" }}/tools/linux_x64/protoc -I../../protos --csharp_out Greeter --grpc_out Greeter ../../protos/helloworld.proto --plugin=protoc-gen-grpc=packages/Grpc.Tools.{{ site.data.config.grpc_release_branch | remove_first: "v" }}/tools/linux_x64/grpc_csharp_plugin
+$ packages/Grpc.Tools.{{ site.data.config.grpc_release_tag | remove_first: "v" }}/tools/linux_x64/protoc -I../../protos --csharp_out Greeter --grpc_out Greeter ../../protos/helloworld.proto --plugin=protoc-gen-grpc=packages/Grpc.Tools.{{ site.data.config.grpc_release_tag | remove_first: "v" }}/tools/linux_x64/grpc_csharp_plugin
 ```
 
 Running the appropriate command for your OS regenerates the following files in

docs/quickstart/node.md

@@ -26,7 +26,7 @@ and other tutorials):
 
 ```sh
 $ # Clone the repository to get the example code
-$ git clone -b {{ site.data.config.grpc_release_branch }} https://github.com/grpc/grpc
+$ git clone -b {{ site.data.config.grpc_release_tag }} https://github.com/grpc/grpc
 $ # Navigate to the dynamic codegen "hello, world" Node example:
 $ cd grpc/examples/node/dynamic_codegen
 $ # Install the example's dependencies

docs/quickstart/objective-c.md

@@ -57,7 +57,7 @@ Quickstart. Copy the source code from Github
 [repository](https://github.com/grpc/grpc):
 
 ```sh
-$ git clone --recursive -b {{ site.data.config.grpc_release_branch }} https://github.com/grpc/grpc.git
+$ git clone --recursive -b {{ site.data.config.grpc_release_tag }} https://github.com/grpc/grpc.git
 ```
 
 ## Install gRPC plugins and libraries

docs/quickstart/php.md

@@ -269,7 +269,7 @@ e.g. [Node.js](node-quickstart.md).
 
 ```sh
 $ # Clone the repository to get the example code:
-$ git clone -b {{ site.data.config.grpc_release_branch }} https://github.com/grpc/grpc
+$ git clone -b {{ site.data.config.grpc_release_tag }} https://github.com/grpc/grpc
 $ # Build grpc_php_plugin to generate proto files if not build before
 $ cd grpc && git submodule update --init && make grpc_php_plugin
 $ # Navigate to the "hello, world" PHP example:

docs/quickstart/python.md

@@ -64,7 +64,7 @@ Python's gRPC tools include the protocol buffer compiler `protoc` and the
 special plugin for generating server and client code from `.proto` service
 definitions. For the first part of our quickstart example, we've already
 generated the server and client stubs from
-[helloworld.proto](https://github.com/grpc/grpc/tree/{{site.data.config.grpc_release_branch}}/examples/protos/helloworld.proto),
+[helloworld.proto](https://github.com/grpc/grpc/tree/{{site.data.config.grpc_release_tag}}/examples/protos/helloworld.proto),
 but you'll need the tools for the rest of our quickstart, as well as later
 tutorials and your own projects.
 
@@ -83,7 +83,7 @@ and other tutorials):
 
 ```sh
 $ # Clone the repository to get the example code:
-$ git clone -b {{ site.data.config.grpc_release_branch }} https://github.com/grpc/grpc
+$ git clone -b {{ site.data.config.grpc_release_tag }} https://github.com/grpc/grpc
 $ # Navigate to the "hello, world" Python example:
 $ cd grpc/examples/python/helloworld
 ```

docs/quickstart/ruby.md

@@ -29,7 +29,7 @@ Ruby's gRPC tools include the protocol buffer compiler `protoc` and the special
 plugin for generating server and client code from the `.proto` service
 definitions. For the first part of our quickstart example, we've already
 generated the server and client stubs from
-[helloworld.proto](https://github.com/grpc/grpc/tree/{{site.data.config.grpc_release_branch}}/examples/protos/helloworld.proto),
+[helloworld.proto](https://github.com/grpc/grpc/tree/{{site.data.config.grpc_release_tag}}/examples/protos/helloworld.proto),
 but you'll need the tools for the rest of our quickstart, as well as later
 tutorials and your own projects.
 
@@ -48,7 +48,7 @@ and other tutorials):
 
 ```sh
 $ # Clone the repository to get the example code:
-$ git clone -b {{ site.data.config.grpc_release_branch }} https://github.com/grpc/grpc
+$ git clone -b {{ site.data.config.grpc_release_tag }} https://github.com/grpc/grpc
 $ # Navigate to the "hello, world" Ruby example:
 $ cd grpc/examples/ruby
 ```