)]}'
{
  "commit": "459a9147eb30d56fe04f6cd63581dd2af42891ee",
  "tree": "270b435da13ec01750b7aeca795652300b98949f",
  "parents": [
    "3e18cd53b614c1b3172209055f15b2ca2ce5058c"
  ],
  "author": {
    "name": "Cy Cheng",
    "email": "cypersonal6@gmail.com",
    "time": "Wed Oct 28 04:42:33 2026 -0700"
  },
  "committer": {
    "name": "Copybara-Service",
    "email": "copybara-worker@google.com",
    "time": "Wed Oct 28 04:44:05 2026 -0700"
  },
  "message": "Fix the documentation of `repository_rule(local \u003d ...)` (#31823)\n\n### Description\n\nRewrites the `doc` of the `local` parameter of `repository_rule`. The old text said a local repo \"should be reevaluated at every fetch\". The new text says what Bazel actually does:\n\n- A local repo is refetched on the usual triggers (a change to the rule definition, its attributes, or a file it reads), plus after every Bazel server restart, because its contents are never reused from a previous server or from the repo contents cache (`shouldUseCachedRepoContents` in `RepositoryFetchFunction`).\n- It is not refetched on every build.\n- It is excluded from `bazel vendor` by default (`isRepoExcludedFromVendoringByDefault`).\n\n### Motivation\n\n\"Every fetch\" reads as \"every build\", which is why #16217 was filed as a bug. The answer there was that this is working as intended and that local repo rules are additionally rerun at every server restart. This PR puts that explanation into the reference docs.\n\nFixes #28497\n\n### Build API Changes\n\nNo\n\n### Checklist\n\n- [ ] I have added tests for the new use cases (if any).\n- [x] I have updated the documentation (if applicable).\n\n### Release Notes\n\nRELNOTES: None\n\nCloses #31823\n\nCOPYBARA_INTEGRATE_REVIEW\u003dhttps://github.com/bazelbuild/bazel/pull/31823 from cycancode:fix-repository-rule-local-doc dd56b854747e525bcdf63cf10f524d7a27ffbd04\nPiperOrigin-RevId: 1008812672\nChange-Id: Icb7775ab74292c19dbfa860cce93df01614b65ba\n",
  "tree_diff": [
    {
      "type": "modify",
      "old_id": "9cf45304efdeb5466d7a9912d38a526cc159b2a9",
      "old_mode": 33188,
      "old_path": "src/main/java/com/google/devtools/build/lib/starlarkbuildapi/repository/RepositoryModuleApi.java",
      "new_id": "659666d6387eebf3feef05d03ca59b3c9cc29a08",
      "new_mode": 33188,
      "new_path": "src/main/java/com/google/devtools/build/lib/starlarkbuildapi/repository/RepositoryModuleApi.java"
    }
  ]
}
