Skip to content

docs: Update documentation on task names#4230

Merged
lucascolley merged 4 commits intoprefix-dev:mainfrom
photex:photex/task-name-doc-update
Jul 29, 2025
Merged

docs: Update documentation on task names#4230
lucascolley merged 4 commits intoprefix-dev:mainfrom
photex:photex/task-name-doc-update

Conversation

@photex
Copy link
Contributor

@photex photex commented Jul 29, 2025

Add a brief section and example of how task names prefixed with _ will be hidden from the output of pixi run and pixi task list.

closes gh-4129

Add a brief section and example of how task names prefixed with _ will
be hidden from the output of `pixi run` and `pixi task list`.
@lucascolley lucascolley self-requested a review July 29, 2025 06:55
@ruben-arts ruben-arts changed the title Update documentation on task names docs: Update documentation on task names Jul 29, 2025
@ruben-arts
Copy link
Contributor

Hey @photex, thanks for helping out!

I tried it locally, but there were some typos resulting in the TOML not working/rendering, I also figured that the example might be a little too verbose, so I've tried to slim it down.

Hope you're content with my changes. @lucascolley please review it!

@photex
Copy link
Contributor Author

photex commented Jul 29, 2025

😅 sorry about that. I’m in a waiting room and didn’t fully try to build everything yet.

@lucascolley lucascolley added documentation Improvements or additions to documentation area:tasks Related to pixi tasks labels Jul 29, 2025
Copy link
Collaborator

@lucascolley lucascolley left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nice! One request: could we add a !!! hint in the depends-on section (just one sentence saying you can hide tasks and linking to #task-names)?

@photex
Copy link
Contributor Author

photex commented Jul 29, 2025

Thanks @lucascolley, I've added a hint as you've suggested. Please let me know if the wording is acceptable. :)

Copy link
Collaborator

@lucascolley lucascolley left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

great stuff, thanks both!

@lucascolley lucascolley enabled auto-merge (squash) July 29, 2025 12:46
@lucascolley lucascolley merged commit cac57e8 into prefix-dev:main Jul 29, 2025
41 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:tasks Related to pixi tasks documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants