diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 35a68e900..dafd78784 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -25,7 +25,7 @@ in [./scala/scala.bzl](./scala/scala.bzl).
 
 ### Code reviews and other contributions.
 **All submissions, including submissions by project members, require review.**
-Please follow the instructions in [the contributors documentation](http://bazel.io/contributing.html).
+Please follow the instructions in [the contributors documentation](https://bazel.build/contribute).
 
 ### The small print
 Contributions made by corporations are covered by a different agreement than
diff --git a/docs/scala_binary.md b/docs/scala_binary.md
index b1016606c..488be7444 100644
--- a/docs/scala_binary.md
+++ b/docs/scala_binary.md
@@ -109,9 +109,9 @@ A `scala_binary` requires a `main_class` attribute.
         <p><code>List of strings; optional</code></p>
         <p>
           Extra compiler options for this binary to be passed to scalac. Subject to
-          <a href="http://bazel.io/docs/be/make-variables.html">Make variable
+          <a href="https://bazel.build/reference/be/make-variables">Make variable
           substitution</a> and
-          <a href="http://bazel.io/docs/be/common-definitions.html#borne-shell-tokenization">Bourne shell tokenization.</a>
+          <a href="https://bazel.build/reference/be/common-definitions.html#sh-tokenization">Bourne shell tokenization.</a>
         </p>
       </td>
     </tr>
@@ -121,9 +121,9 @@ A `scala_binary` requires a `main_class` attribute.
         <p><code>List of strings; optional</code></p>
         <p>
           List of JVM flags to be passed to the executing JVM. Subject to
-          <a href="http://bazel.io/docs/be/make-variables.html">Make variable
+          <a href="https://bazel.build/reference/be/make-variables.html">Make variable
           substitution</a> and
-          <a href="http://bazel.io/docs/be/common-definitions.html#borne-shell-tokenization">Bourne shell tokenization.</a>
+          <a href="https://bazel.build/reference/be/common-definitions.html#sh-tokenization">Bourne shell tokenization.</a>
         </p>
       </td>
     </tr>
@@ -134,9 +134,9 @@ A `scala_binary` requires a `main_class` attribute.
         <p>
           List of JVM flags to be passed to scalac after the
           <code>scalacopts</code>. Subject to
-          <a href="http://bazel.io/docs/be/make-variables.html">Make variable
+          <a href="https://bazel.build/reference/be/make-variables.html">Make variable
           substitution</a> and
-          <a href="http://bazel.io/docs/be/common-definitions.html#borne-shell-tokenization">Bourne shell tokenization.</a>
+          <a href="https://bazel.build/reference/be/common-definitions.html#sh-tokenization">Bourne shell tokenization.</a>
         </p>
       </td>
     </tr>
@@ -147,9 +147,9 @@ A `scala_binary` requires a `main_class` attribute.
         <p>
           List of JVM flags to be passed to javac after the
           <code>javacopts</code>. Subject to
-          <a href="http://bazel.io/docs/be/make-variables.html">Make variable
+          <a href="https://bazel.build/reference/be/make-variables.html">Make variable
           substitution</a> and
-          <a href="http://bazel.io/docs/be/common-definitions.html#borne-shell-tokenization">Bourne shell tokenization.</a>
+          <a href="https://bazel.build/reference/be/common-definitions.html#sh-tokenization">Bourne shell tokenization.</a>
         </p>
       </td>
     </tr>
@@ -164,4 +164,4 @@ A `scala_binary` requires a `main_class` attribute.
       </td>
     </tr>
   </tbody>
-</table>
\ No newline at end of file
+</table>
diff --git a/docs/scala_library.md b/docs/scala_library.md
index 56c4e5248..0f8ec28f3 100644
--- a/docs/scala_library.md
+++ b/docs/scala_library.md
@@ -121,9 +121,9 @@ In order to have a Java rule use this jar file, use the `java_import` rule.
         <p><code>List of strings; optional</code></p>
         <p>
           Extra compiler options for this library to be passed to scalac. Subject to
-          <a href="http://bazel.io/docs/be/make-variables.html">Make variable
+          <a href="https://bazel.build/reference/be/make-variables.html">Make variable
           substitution</a> and
-          <a href="http://bazel.io/docs/be/common-definitions.html#borne-shell-tokenization">Bourne shell tokenization.</a>
+          <a href="https://bazel.build/reference/be/common-definitions.html#sh-tokenization">Bourne shell tokenization.</a>
         </p>
       </td>
     </tr>
@@ -143,9 +143,9 @@ In order to have a Java rule use this jar file, use the `java_import` rule.
         <p>
           List of JVM flags to be passed to scalac after the
           <code>scalacopts</code>. Subject to
-          <a href="http://bazel.io/docs/be/make-variables.html">Make variable
+          <a href="https://bazel.build/reference/be/make-variables.html">Make variable
           substitution</a> and
-          <a href="http://bazel.io/docs/be/common-definitions.html#borne-shell-tokenization">Bourne shell tokenization.</a>
+          <a href="https://bazel.build/reference/be/common-definitions.html#sh-tokenization">Bourne shell tokenization.</a>
         </p>
       </td>
     </tr>
@@ -156,9 +156,9 @@ In order to have a Java rule use this jar file, use the `java_import` rule.
         <p>
           List of JVM flags to be passed to javac after the
           <code>javacopts</code>. Subject to
-          <a href="http://bazel.io/docs/be/make-variables.html">Make variable
+          <a href="https://bazel.build/reference/be/make-variables.html">Make variable
           substitution</a> and
-          <a href="http://bazel.io/docs/be/common-definitions.html#borne-shell-tokenization">Bourne shell tokenization.</a>
+          <a href="https://bazel.build/reference/be/common-definitions.html#sh-tokenization">Bourne shell tokenization.</a>
         </p>
       </td>
     </tr>
@@ -173,4 +173,4 @@ In order to have a Java rule use this jar file, use the `java_import` rule.
       </td>
     </tr>
   </tbody>
-</table>
\ No newline at end of file
+</table>
diff --git a/docs/scala_macro_library.md b/docs/scala_macro_library.md
index c61e6c093..d13179e01 100644
--- a/docs/scala_macro_library.md
+++ b/docs/scala_macro_library.md
@@ -122,9 +122,9 @@ In order to have a Java rule use this jar file, use the `java_import` rule.
         <p><code>List of strings; optional</code></p>
         <p>
           Extra compiler options for this library to be passed to scalac. Subject to
-          <a href="http://bazel.io/docs/be/make-variables.html">Make variable
+          <a href="https://bazel.build/reference/be/make-variables.html">Make variable
           substitution</a> and
-          <a href="http://bazel.io/docs/be/common-definitions.html#borne-shell-tokenization">Bourne shell tokenization.</a>
+          <a href="https://bazel.build/reference/be/common-definitions.html#sh-tokenization">Bourne shell tokenization.</a>
         </p>
       </td>
     </tr>
@@ -144,9 +144,9 @@ In order to have a Java rule use this jar file, use the `java_import` rule.
         <p>
           List of JVM flags to be passed to scalac after the
           <code>scalacopts</code>. Subject to
-          <a href="http://bazel.io/docs/be/make-variables.html">Make variable
+          <a href="https://bazel.build/reference/be/make-variables.html">Make variable
           substitution</a> and
-          <a href="http://bazel.io/docs/be/common-definitions.html#borne-shell-tokenization">Bourne shell tokenization.</a>
+          <a href="https://bazel.build/reference/be/common-definitions.html#sh-tokenization">Bourne shell tokenization.</a>
         </p>
       </td>
     </tr>
@@ -157,9 +157,9 @@ In order to have a Java rule use this jar file, use the `java_import` rule.
         <p>
           List of JVM flags to be passed to javac after the
           <code>javacopts</code>. Subject to
-          <a href="http://bazel.io/docs/be/make-variables.html">Make variable
+          <a href="https://bazel.build/reference/be/make-variables.html">Make variable
           substitution</a> and
-          <a href="http://bazel.io/docs/be/common-definitions.html#borne-shell-tokenization">Bourne shell tokenization.</a>
+          <a href="https://bazel.build/reference/be/common-definitions.html#sh-tokenization">Bourne shell tokenization.</a>
         </p>
       </td>
     </tr>
@@ -174,4 +174,4 @@ In order to have a Java rule use this jar file, use the `java_import` rule.
       </td>
     </tr>
   </tbody>
-</table>
\ No newline at end of file
+</table>