| commit | aba1a01295094e9df40fc94e355f54e7e98dcd33 | [log] [tgz] |
|---|---|---|
| author | Alexandre Rostovtsev <arostovtsev@google.com> | Tue Jun 18 14:40:59 2024 -0400 |
| committer | GitHub <noreply@github.com> | Tue Jun 18 14:40:59 2024 -0400 |
| tree | e52ce020876721a534c637874230d836c818d2c3 | |
| parent | f39ed53f56f2de895b2f1891fa166b2b3b0e3fe7 [diff] |
Update test regeneration script to support multiple Bazel versions (#232) Refactor stardoc_test() to create regenerator binaries for each golden test, and have update-stardoc-tests.sh query for those regenerator binaries and run them with the appropriate version of Bazel. As a side effect, this makes virtually all of Stardoc's tests auto-updateable, reducing maintenance burden. Also take the opportunity to switch manual legacy tests from Bazel 7.1 to 7.2
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.