I just noticed, that in the docs for Goals, there’...
# developmentc
curved-television-6568
09/22/2021, 8:30 AMI just noticed, that in the docs for Goals, there’s a section with “Related Subsystems”. However, it includes itself as well there. I guess the proper fix would be to simply filter out any goals, and that it would exclude itself and leave just subsystems, as it should.
h
happy-kitchen-89482
09/22/2021, 3:16 PMEvery goal has a companion subsystem that configures the goal, so I think that's what you're seeing.
👍 1
c
curved-television-6568
09/22/2021, 4:38 PMWell, the link points at the page I'm at, so something is amiss.. on the phone now, can post link/screenshot when I get back..
curved-television-6568
09/22/2021, 5:21 PMWell, most links under “Related subsystem” are indeed to documented subsystems. But the current goal whose doc page I’m reading is always also listed under related subsystems. That’s a little confused.
curved-television-6568
09/22/2021, 5:22 PMThe roots goal for instance, is an easy example, as there’s just two links under the related subsystems heading: https://www.pantsbuild.org/v2.8/docs/reference-roots
curved-television-6568
09/22/2021, 5:23 PMThe roots link points to the page I’m already at.
curved-television-6568
09/22/2021, 5:24 PMOh, or do you mean there actually also is a
rootsh
happy-kitchen-89482
09/22/2021, 8:02 PMHmm, yes, so I think the documentation page for a goal is actually the documentation page for its subsystem, so I think you're right
👌 1
c
curved-television-6568
10/06/2021, 7:47 AMAh, stumbled upon this again, but for the CLI help output, and there it is addressed properly:
https://github.com/pantsbuild/pants/blob/964d9d8ddc167ea498da6d05af626c1252f56687/src/python/pants/help/help_printer.py#L253
Copy code
related_scopes = sorted(set(goal_info.consumed_scopes) - {GLOBAL_SCOPE, goal_info.name})