Introduce --incompatible_load_argument_is_label (1st argument of load must be a label).

RELNOTES:
  First argument of 'load' should be a label. Path syntax is deprecated
  (label should start with '//' or ':').
PiperOrigin-RevId: 158971314

1 files changed, 14 insertions, 0 deletions

diff --git a/site/docs/skylark/concepts.md b/site/docs/skylark/concepts.md
index dcaebc9012..e078810315 100644
--- a/site/docs/skylark/concepts.md
+++ b/site/docs/skylark/concepts.md
@@ -173,6 +173,20 @@ with Python. A possible workaround is to use the `.update` method instead.
 *   Flag: `--incompatible_disallow_dict_plus`
 *   Default: `false`
 
+### Load argument is a label
+
+Historically, the first argument of `load` could be a path with an implicit
+`.bzl` suffix. We are going to require that all `load` statements use the label
+syntax.
+
+``` python
+load("/path/foo", "var")  # deprecated
+load("//path:foo.bzl", "var")  # recommended
+```
+
+*   Flag: `--incompatible_load_argument_is_label`
+*   Default: `false`
+
 ### Top level `if` statements
 
 This change forbids `if` statements at the top level of `.bzl` files (they are