bazelbuild/bazel
Ver no GitHubDiscoverability of language-agnostic rules is poor
Open
#22.645 aberto em 5 de jun. de 2024
P2help wantedteam-Documentationteam-OSStype: documentation (cleanup)
Métricas do repositório
- Stars
- (25.384 stars)
- Métricas de merge de PR
- (Mesclagem média 22d 20h) (77 fundiu PRs em 30d)
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