bug: docs should say which version each feature / function / etc. was introduced in

Page link:

No response

Problem description (include actual vs expected text, if applicable):

Major programming languages/platforms like node.js and python in their docs list when each function / api was introduced. This makes it far easier to use the latest docs, yet actually be targeting or at least supporting an older version of the language. Bazel should do the same: each new function, new parameter, change in behavior etc. should be documented in bazel docs with which semver version it was introduced in.

some related discussion in: https://github.com/bazelbuild/bazel/issues/9016#issuecomment-2118679907

Where do you see this issue? (include link to specific section of the page, if applicable)

I know of it most on the repository_ctx page as there were a lot of improvements / features added there over bazel 7 - I was at the time using bazel 6 and was misled by the latest docs that repository_ctx including features I couldn't actually use. In particular, repository_ctx.getenv was an api I wanted to use in bazel 6 that I discovered the hard way was not available until bazel 7.

Any other information you'd like to share?

No response