| commit | c026daeee09fb072a02be87dfc87ea60d157e770 | [log] [tgz] |
|---|---|---|
| author | Alexandre Rostovtsev <arostovtsev@google.com> | Mon Jun 24 10:12:51 2024 -0400 |
| committer | GitHub <noreply@github.com> | Mon Jun 24 10:12:51 2024 -0400 |
| tree | 54351ecfa1a0428e088c54e75aedb7fc341c822d | |
| parent | 7f0601624ceb55c84690ba9fc86a097a4c7cf6b8 [diff] |
Improve incompatible flag testing (#238) We always want to use some flags in development; e.g. an empty glob is a sign of a mistake, so we always want --incompatible_disallow_empty_glob We will unconditionally set such flags in .bazelrc (not just in CI config). For other incompatible flags (--incompatible_enable_proto_toolchain_resolution), we want to test builds both with and without them - and with bzlmod both enabled and disabled (see discussion in #236 for a case where this matters). Such flags we will group under --config=incompatible, and test all 4 combinations (+- incompatible +- bzlmod) in CI.
Stardoc is a documentation generator for Bazel build rules written in Starlark.
Stardoc provides a Starlark rule (stardoc, see documentation) that can be used to build documentation for Starlark rules in Markdown. Stardoc generates one documentation page per .bzlfile.
Stardoc is a replacement for the deprecated “Skydoc” documentation generator.
See Skydoc Deprecation for details on the deprecation and migration details.
See our future plans for refactoring Stardoc to be more consistent with how Bazel evaluates .bzl files, and what it means for maintenance of this project.
See the maintaner's guide for instructions for cutting a new release.