Skip to content

docs: update bazelrc, bzlmod, caching and bep documentation#29042

Closed
deepalak56 wants to merge 2 commits intomasterfrom
copilot/update-bazel-docs-import-depth
Closed

docs: update bazelrc, bzlmod, caching and bep documentation#29042
deepalak56 wants to merge 2 commits intomasterfrom
copilot/update-bazel-docs-import-depth

Conversation

@deepalak56
Copy link
Copy Markdown
Contributor

@deepalak56 deepalak56 commented Mar 21, 2026

Documents four new behavioral changes in Bazel across four topic areas.

Changes

  • .bazelrc import depth (run/bazelrc.md, run/bazelrc.mdx): Documents the new 512-file recursive import depth limit, the "Maximum import depth exceeded parsing config file" error, and the BAZEL_UNLIMITED_IMPORT_DEPTH escape hatch.

  • Bzlmod integrity enforcement (external/registry.md, external/registry.mdx): Clarifies that integrity checksum values for patches and overlay entries in source.json must now be non-empty. Covers all three source types (archive, git_repository).

  • Remote cache chunked transfer (remote/caching.md, remote/caching.mdx): Adds a "Chunked transfer" subsection documenting --experimental_remote_cache_chunking for large blob transfers. Notes server-side support requirement.

  • BEP parent-child ordering (remote/bep.md, remote/bep.mdx): Replaces the old caveat that parent events might precede children with the new guarantee that BEP events respect parent-child ordering constraints.

All changes are mirrored identically between legacy .md (site/en/) and modern .mdx (docs/) files.

Build API Changes

No

Checklist

  • I have added tests for the new use cases (if any).
  • I have updated the documentation (if applicable).

Release Notes

RELNOTES: None


⌨️ Start Copilot coding agent tasks without leaving your editor — available in VS Code, Visual Studio, JetBrains IDEs and Eclipse.

@github-actions github-actions Bot added team-Documentation Documentation improvements that cannot be directly linked to other team labels awaiting-review PR is awaiting review from an assigned reviewer labels Mar 21, 2026
@deepalak56
Copy link
Copy Markdown
Contributor Author

1021 preexisting errors because of mdx rules - raw urls, html errors (some like without closing tag), some random braces, html comments in JSX etc.

@deepalak56 deepalak56 force-pushed the copilot/update-bazel-docs-import-depth branch from 3a182f2 to d1e4758 Compare March 21, 2026 20:07
@meteorcloudy
Copy link
Copy Markdown
Member

@fweikert Can you take a look at the presubmit failure?

@fweikert
Copy link
Copy Markdown
Member

@fweikert Can you take a look at the presubmit failure?

I updated the docs post-submit pipeline to not report a status to GitHub while the migration is still going on.

@iancha1992 iancha1992 added team-OSS Issues for the Bazel OSS team: installation, release processBazel packaging, website awaiting-PR-merge PR has been approved by a reviewer and is ready to be merge internally and removed awaiting-review PR is awaiting review from an assigned reviewer labels Mar 23, 2026
@deepalak56 deepalak56 closed this Mar 25, 2026
@github-actions github-actions Bot removed the awaiting-PR-merge PR has been approved by a reviewer and is ready to be merge internally label Mar 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

team-Documentation Documentation improvements that cannot be directly linked to other team labels team-OSS Issues for the Bazel OSS team: installation, release processBazel packaging, website type: documentation (cleanup) untriaged

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants