bazelbuild/bazel
Auf GitHub ansehenDiscoverability of language-agnostic rules is poor
Open
#22.645 geöffnet am 5. Juni 2024
P2help wantedteam-Documentationteam-OSStype: documentation (cleanup)
Repository-Metriken
- Stars
- (25.384 Stars)
- PR-Merge-Metriken
- (Durchschn. Merge 22T 20h) (77 gemergte PRs in 30 T)
Beschreibung
Page link:
No response
Problem description (include actual vs expected text, if applicable):
For a new Bazel user, it can be hard to find all the language-agnostic rules that they should leverage instead of reimplementing. Today they are split between at least three locations:
- Native rules, documented at https://bazel.build/reference/be/overview#language-agnostic-native-rules (this is good!)
- Bazel Skylib, which provides additional, very widely used language-agnostic rules, but is not mentioned in https://bazel.build/reference/be/overview. It's linked to from https://bazel.build/rules, but the text there makes it sound like it contains advanced utilities for rules-writers, not everyday utility rules for regular users like
copy_fileornative_binary("The repository Skylib contains additional functions that can be useful when writing new rules and new macros."). - rules_platform, which provides
platform_data, is not even listed in https://bazel.build/rules.
Where do you see this issue? (include link to specific section of the page, if applicable)
No response
Any other information you'd like to share?
No response