https://pantsbuild.org/ logo
a

ambitious-actor-36781

11/16/2021, 8:52 AM
./pants --loop test check fmt lint
is amazing. thank you.
šŸ‘– 2
šŸ’Æ 3
ā¤ļø 1
h

happy-kitchen-89482

11/16/2021, 3:10 PM
You can even add a CLI alias to shorten that invocation, say by setting
green = "test check fmt lint"
h

hundreds-father-404

11/16/2021, 6:18 PM
This reminds me, any suggestions for where we should document CLI aliases? cc @curved-television-6568
šŸ‘€ 1
c

curved-television-6568

11/16/2021, 6:25 PM
Looking now, and the first thing that hits me is, that I think the topics under ā€œUsing Pants / Key conceptsā€ are so essential, that it almost would be better to move them up one level (as now, you don’t see them unless you unfold the ā€œKey conceptsā€ section in the nav menu.
āž• 1
I for one, have overlooked that there is a page dedicated to list all available backends, which is great.
šŸ’Æ 1
But I think cli aliases fits under the ā€œUsing Pantsā€ chapter.
h

hundreds-father-404

11/16/2021, 6:26 PM
Ohh maybe have a "Key Concepts" section! And then we can nest "Using Pants" like we did with "Getting Started". What do you think @happy-kitchen-89482?
āž• 1
c

curved-television-6568

11/16/2021, 6:27 PM
I think I like that.
h

hundreds-father-404

11/16/2021, 6:27 PM
(The general tension we have is that the left nav bar is too crowded)
c

curved-television-6568

11/16/2021, 6:28 PM
I see (also, the nav is almost useless on mobile..) As you can’t navigate to the ā€œoverviewā€ pages, as they’re all the same on mobile…
h

hundreds-father-404

11/16/2021, 6:28 PM
yeah nav on mobile is so long also, it's horrible
c

curved-television-6568

11/16/2021, 6:29 PM
Yeah, but if it worked, it would still at least be usable šŸ˜‰
šŸ‘ 1
With more languages, the nav is only going to get bigger… perhaps we need to find a way to partition it, so you don’t have to see the whole thing all the time..
h

hundreds-father-404

11/16/2021, 6:30 PM
That's what the folders/sections are supposed to be for. Like I really like how Python is only 3 top-level pages. (Even if I hate how it renders on mobile)
c

curved-television-6568

11/16/2021, 6:31 PM
That’s a good example actually.. and if more sections where like that, it would be easier to spot which were available, and force you to unfold the ones you care about…
šŸ‘ 1
In that sense, Key concepts are correct (or could be promoted entirely..?) but the other sub sections of ā€œUsing pantsā€ should find a small set of categories to be grouped under..
āž• 1
h

hundreds-father-404

11/16/2021, 6:34 PM
I think my proposal is: • New "Key concepts" section (chapter), but still keep it nested into a folder. Like the Getting Started section • Nest "Using Pants" into a folder, like Getting Started • Maybe rename "Using Pants"?
but I'll leave @happy-kitchen-89482 to do what he sees fit. He's been doing structural reorganization of docs, I've been focused on refreshing the content
šŸ‘ 2
c

curved-television-6568

11/16/2021, 6:35 PM
There’s probably, something like: • Configuration • Execution • Troubleshooting To get started..
šŸ’Æ 1
Maybe rename ā€œUsing Pantsā€?
Yeah, as everything in the docs is about using pants, one way or another (except a few topics under ā€œIntroductionā€ perhaps..)
āž• 1
h

hundreds-father-404

11/16/2021, 6:41 PM
I wanted to call it "Advanced Usage", but it's really not! Things like resources are an important idea. Yet also not as "Key"/foundational as the "Key Concepts" section.. It's more like "Generic features you are likely to need regardless of which languages you use"
šŸ‘ 1
c

curved-television-6568

11/16/2021, 6:43 PM
or ā€œThe Basicsā€ šŸ˜‰
āž• 1
h

hundreds-father-404

11/16/2021, 6:45 PM
Something like that! I view it as: • Key concepts -> you really really will benefit from reading this, regardless of who you are • "the basics" -> you can probably get away with not reading this start-to-finish and it's fine to read ad-hoc. You will likely need to see these pages eventually tho
šŸ’Æ 1
a

ambitious-actor-36781

11/16/2021, 9:45 PM
One thing I will add. the output from
./pants test fmt lint check
is can be quite spammy and often I find it hard to work out what commands output starts where.
āž• 2
h

happy-kitchen-89482

11/16/2021, 11:44 PM
What would make it better? A separator of some kind between the tools?
a

ambitious-actor-36781

11/17/2021, 12:07 AM
yeah, maybe. or maybe just between the goals
also, another thing i've noticed today.
--loop
'consumes' the pantsd 'slot' or whatever you call it. (same with
pants run //dev/server/
) so everything else you run needs
PANTS_CONCURRENT=yes
which I can't tell if it shouldn't be the case, or I just need to configure it myself.
h

hundreds-father-404

11/17/2021, 12:11 AM
yeah, that's a highly requested feature: https://github.com/pantsbuild/pants/issues/7654. We've been chipping away at it! I agree it's important
a

ambitious-actor-36781

11/17/2021, 12:11 AM
šŸ‘Œ nice
3 Views