diff --git a/src/main/java/com/google/devtools/build/lib/skylarkbuildapi/StarlarkRuleContextApi.java b/src/main/java/com/google/devtools/build/lib/skylarkbuildapi/StarlarkRuleContextApi.java
index bd4b120..2316d5c 100644
--- a/src/main/java/com/google/devtools/build/lib/skylarkbuildapi/StarlarkRuleContextApi.java
+++ b/src/main/java/com/google/devtools/build/lib/skylarkbuildapi/StarlarkRuleContextApi.java
@@ -589,7 +589,7 @@
             named = true,
             doc =
                 "<b>Use of this parameter is not recommended. See "
-                    + "<a href=\"../rules.html#runfiles\">runfiles guide</a></b>. "
+                    + "<a href=\"../rules.$DOC_EXT#runfiles\">runfiles guide</a></b>. "
                     + "<p>Whether to collect the data "
                     + "runfiles from the dependencies in srcs, data and deps attributes."),
         @Param(
@@ -599,7 +599,7 @@
             named = true,
             doc =
                 "<b>Use of this parameter is not recommended. See "
-                    + "<a href=\"../rules.html#runfiles\">runfiles guide</a></b>. "
+                    + "<a href=\"../rules.$DOC_EXT#runfiles\">runfiles guide</a></b>. "
                     + "<p>Whether to collect the default "
                     + "runfiles from the dependencies in srcs, data and deps attributes."),
         @Param(
@@ -607,13 +607,19 @@
             type = Dict.class,
             defaultValue = "{}",
             named = true,
-            doc = "The map of symlinks to be added to the runfiles, prefixed by workspace name."),
+            doc =
+                "The map of symlinks to be added to the runfiles, prefixed by workspace name. See "
+                    + "<a href=\"../rules.$DOC_EXT#runfiles-symlinks\">Runfiles symlinks</a> in "
+                    + "the rules guide."),
         @Param(
             name = "root_symlinks",
             type = Dict.class,
             defaultValue = "{}",
             named = true,
-            doc = "The map of symlinks to be added to the runfiles.")
+            doc =
+                "The map of symlinks to be added to the runfiles. See "
+                    + "<a href=\"../rules.$DOC_EXT#runfiles-symlinks\">Runfiles symlinks</a> in "
+                    + "the rules guide.")
       })
   RunfilesApi runfiles(
       Sequence<?> files,