I feel like the docs are also missing a high-level intro on what Pants like to use once it's set up. The 'How does Pants work?' page describes a bunch of features. I'd really like something that's more like: • Pants uses BUILD files to indicate the individual things (targets) that need to be built • You can build all things, or a subset of them by running these commands: .... • You can e.g. package a python module and add it to a docker image, or run a shell script. • You can run other actions (goals) on targets .... etc. I think otherwise you need to dig into targets and goals and subsystems and there's a lot of detail which is a bit overwhelming. Just thinking out loud here anyway - apologies if i've missed a page somewhere

I think this is good information, and I don't think there's any need to apologize. Because, if you've missed a page somewhere, maybe that page (if it exists) wasn't prominent enough 🤷 Would you consider spinning this into a GH discussion, and maybe we can see what's covered, what's missing, and figure out a more reliable getting-started process