search

bazelbuild / bazel

a fast, scalable, multi-language and extensible build system
https://bazel.build
Apache License 2.0
23.21k stars 4.07k forks source link

Documentation issue: Depsets This page content belongs in a different place #13539

Open aiuto opened 3 years ago

aiuto commented 3 years ago

Documentation URL: https://docs.bazel.build/versions/master/skylark/depsets.html

There are two problems.

  1. This page has vital information about using the API. Specifically, how to construct a depset. It belong in the page where the API is described. https://docs.bazel.build/versions/master/skylark/lib/depset.html

  2. Neither of the pages belong under .../skylark/. Depsets are not a Starlark feature, they are Bazel specific. It belongs in a "rule writing" section, which is not present in the current sidebar navigation.

fweikert commented 1 year ago

We moved the file to https://bazel.build/extending/depsets, which partially addresses this issue.

aiuto commented 1 year ago

That helps a lot. The conceptual information is now with the the other big concepts. Thanks!