bazelbuild/bazel
Voir sur GitHubDiscoverability of language-agnostic rules is poor
Open
#22 645 ouverte le 5 juin 2024
P2help wantedteam-Documentationteam-OSStype: documentation (cleanup)
Métriques du dépôt
- Stars
- (25 384 stars)
- Métriques de merge PR
- (Merge moyen 22j 20h) (77 PRs mergées en 30 j)
Description
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