Tweak configuration documentation

- "default configuration" -> "rule's current configuration"
- Rendering bug at https://bazel.build/rules/lib/builtins/configuration#test_env.

Closes #27714.

PiperOrigin-RevId: 834387681
Change-Id: Ie4c0ce9de72e06fe6d60e26ef4c20a18229180c4

Author: gregestren

src/main/java/com/google/devtools/build/lib/starlarkbuildapi/BuildConfigurationApi.java

@@ -61,7 +61,7 @@ public interface BuildConfigurationApi extends StarlarkValue {
       structField = true,
       doc =
           "A dictionary containing user-specified test environment variables and their values, as"
-              + " set by the --test_env options. DO NOT USE! This is not the complete"
+              + " set by the <code>--test_env</code> options. DO NOT USE! This is not the complete"
               + " environment!")
   ImmutableMap<String, String> getTestEnv();
 
@@ -91,7 +91,8 @@ public interface BuildConfigurationApi extends StarlarkValue {
             <li>The value may differ across Bazel versions, including patch releases. \
             <li>The value encodes the value of <b>every</b> flag, including those that aren't \
                 otherwise relevant for the current target and may thus invalidate caches more \
-                frequently.
+                frequently. \
+          </ul>
           """)
   String getShortId();
 

src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleContextApi.java

@@ -206,8 +206,10 @@ public interface StarlarkRuleContextApi<ConstraintValueT extends ConstraintValue
       name = "configuration",
       structField = true,
       doc =
-          "The default configuration. See the <a href=\"../builtins/configuration.html\">"
-              + "configuration</a> type for more details.")
+          "The current target's build configuration. See the <a"
+              + " href=\"../builtins/configuration.html\">Starlark configuration type</a> and <a"
+              + " href=\"/extending/rules#configurations\">configuration documentation</a> for more"
+              + " details.")
   BuildConfigurationApi getConfiguration() throws EvalException;
 
   @StarlarkMethod(