Soften language of deprecating //command_line_option:x syntax
PiperOrigin-RevId: 299858785
diff --git a/site/docs/skylark/config.md b/site/docs/skylark/config.md
index 2e2e6d8..da81a8e 100644
--- a/site/docs/skylark/config.md
+++ b/site/docs/skylark/config.md
@@ -460,7 +460,10 @@
Outgoing edge transitions can be 1:1 or 1:2+.
### Transitions on native options
-WARNING: This feature will be deprecated soon. Use at your own risk.
+WARNING: Long term, we plan to reimplement all native options as build settings.
+When that happens, this syntax will be deprecated. Currently other issues are
+blocking that migration but be aware you may have to migrate your transitions
+at some point in the future.
Starlark transitions can also declare reads and writes on native options via
a special prefix to the option name.
