I'm evaluating Pants and it looks amazing. One quick feedback: it took me forever to figure out

build_file_dir()

or symbols in general. It's not mentioned in the current documentaion at all!

Thanks for pointing that out -

pants help

and in this case

pants help symbols

can be useful here, but you're right, those should be readily available on the website . I didn't even know about

build_file_dir

until just now 😆 Would you mind opening a ticket? Also, if you're a VSCode user - I've got a plugin that will soon be getting BUILD LSP support whenever I can setup the file watcher piece that will auto-update the LSP if pants.toml changes. That should help a bit too. Something like this

Huh.. I'm surprised it's not mentioned around here: https://www.pantsbuild.org/2.20/docs/using-pants/key-concepts/targets-and-build-files#build-files along with

env()

which is the "same kind of" thing.. there're not many of these, but the few there are ought to be documented 😂

Yeah, but they don't have a section in the reference API - that's the real surprise to me. I think it was introduced in like 2.11

seems so, according to the notes: https://www.pantsbuild.org/blog/2022/05/02/introducing-pants-2-11#other-changes

That should be in there somewhere for sure. https://github.com/pantsbuild/pantsbuild.org/issues/212