Skip to content

feat: port stardoc_with_diff_test macro#303

Open
alexeagle wants to merge 2 commits into
bazelbuild:masterfrom
alexeagle:patch-1
Open

feat: port stardoc_with_diff_test macro#303
alexeagle wants to merge 2 commits into
bazelbuild:masterfrom
alexeagle:patch-1

Conversation

@alexeagle

Copy link
Copy Markdown
Contributor

This feature was dropped in bazel-lib 3.0 (since many rulesets can now just surface docs on registry.bazel.build rather than check them into the repo)

bazel-contrib/bazel-lib#1188

This implementation is by a few authors, starting with me: https://github.com/bazel-contrib/rules_go/commits/7ef8fb1bc91d2ea70a53fe123ea0556acb3bf87b/docs/doc_helpers.bzl

rulesets that want to continue checking in their generated markdown files will prefer to have this from the stardoc module, as that's the primary dependency this macro takes.

@malt3

malt3 commented Nov 27, 2025

Copy link
Copy Markdown

Could someone take a look at this? I'd like to update aspect_bazel_lib to bazel_lib and this would be the new logical home for this.

@lalten

lalten commented Apr 3, 2026

Copy link
Copy Markdown

bump on this

Comment thread stardoc/stardoc_with_diff_test.bzl Outdated
Comment thread stardoc/stardoc_with_diff_test.bzl
lalten added a commit to lalten/rules_appimage that referenced this pull request Apr 3, 2026
Also switch from aspect_bazel_lib to its new name, bazel_lib. This needs
a patch due to bazelbuild/stardoc#303. This is
ok because stardoc is a Bzlmod only dev_dependency in rules_appimage
@lalten

lalten commented Apr 4, 2026

Copy link
Copy Markdown

Some more changes might be needed to work with latest stardoc and place the generated output at the right location, see lalten/rules_appimage#416

@alexeagle

Copy link
Copy Markdown
Contributor Author

I'd rather not put more work into this PR given the unlikelihood that maintainers will look at it or would be willing to merge it...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants