docs(tasks): create dedicated monorepo tasks documentation#6561
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull Request Overview
Creates dedicated documentation for monorepo tasks functionality and reorganizes existing documentation by moving content from the task configuration page to a new standalone guide.
- Extracts comprehensive monorepo task documentation from
task-configuration.mdto new dedicated page - Documents tool inheritance feature for subdirectory tasks
- Updates cross-references to point to the new monorepo documentation
Reviewed Changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| docs/tasks/monorepo.md | New comprehensive guide covering monorepo task syntax, configuration, tool inheritance, and best practices |
| docs/tasks/task-configuration.md | Replaced detailed monorepo section with brief overview and link to dedicated documentation |
| docs/configuration.md | Added mention of tool inheritance feature and updated documentation link |
Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.
cb7402a to
0a9ca2f
Compare
Hyperfine Performance
|
| Command | Mean [ms] | Min [ms] | Max [ms] | Relative |
|---|---|---|---|---|
mise-2025.10.3 x -- echo |
17.6 ± 0.2 | 17.3 | 18.6 | 1.00 |
mise x -- echo |
17.7 ± 0.2 | 17.3 | 19.6 | 1.01 ± 0.02 |
mise env
| Command | Mean [ms] | Min [ms] | Max [ms] | Relative |
|---|---|---|---|---|
mise-2025.10.3 env |
17.1 ± 0.4 | 16.7 | 22.1 | 1.00 |
mise env |
17.3 ± 0.5 | 16.8 | 22.2 | 1.01 ± 0.03 |
mise hook-env
| Command | Mean [ms] | Min [ms] | Max [ms] | Relative |
|---|---|---|---|---|
mise-2025.10.3 hook-env |
16.8 ± 0.6 | 16.4 | 26.8 | 1.00 |
mise hook-env |
17.0 ± 0.4 | 16.4 | 21.4 | 1.01 ± 0.04 |
mise ls
| Command | Mean [ms] | Min [ms] | Max [ms] | Relative |
|---|---|---|---|---|
mise-2025.10.3 ls |
14.7 ± 0.2 | 14.4 | 15.4 | 1.00 |
mise ls |
14.9 ± 0.4 | 14.4 | 20.2 | 1.02 ± 0.03 |
xtasks/test/perf
| Command | mise-2025.10.3 | mise | Variance |
|---|---|---|---|
| install (cached) | 194ms | ✅ 105ms | +84% |
| ls (cached) | 62ms | 63ms | -1% |
| bin-paths (cached) | 68ms | 69ms | -1% |
| task-ls (cached) | 465ms | 477ms | -2% |
✅ Performance improvement: install cached is 84%
- Create comprehensive monorepo tasks guide at docs/tasks/monorepo.md - Document tool inheritance from parent configs - Update task-configuration.md to reference new monorepo doc - Update configuration.md to mention tool inheritance feature - Consolidate all monorepo information in one place 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
0a9ca2f to
ee640b6
Compare
Contributor
There was a problem hiding this comment.
Pull Request Overview
Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.
Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
jdx
pushed a commit
that referenced
this pull request
Oct 7, 2025
### 📦 Registry - add jules by @alefteris in [#6568](#6568) ### 🐛 Bug Fixes - **(docs)** improve favicon support for Safari by @jdx in [#6567](#6567) - **(github)** download assets via API to respect GITHUB_TOKEN by @roele in [#6496](#6496) - **(task)** load toml tasks in `task_config.includes` in system/global config and monorepo subdirs by @risu729 in [#6545](#6545) - **(task)** handle dots in monorepo directory names correctly by @jdx in [#6571](#6571) ### 📚 Documentation - **(readme)** add GitHub Issues & Discussions section by @rsyring in [#6573](#6573) - **(tasks)** create dedicated monorepo tasks documentation by @jdx in [#6561](#6561) - **(tasks)** enhance monorepo documentation with tool comparisons by @jdx in [#6563](#6563)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Creates comprehensive documentation for monorepo tasks in a dedicated page and updates related documentation to reference it.
Changes
New documentation:
docs/tasks/monorepo.md- comprehensive guide covering:Updated references:
docs/tasks/task-configuration.md- replaced full monorepo section with link to new docdocs/configuration.md- added mention of tool inheritance feature and updated linkWhy
The monorepo task information was embedded in the task configuration page, making it hard to find and navigate. With the recent addition of tool inheritance support (#6559), this seemed like a good time to:
🤖 Generated with Claude Code
Note
Adds a dedicated Monorepo Tasks doc, updates existing docs to reference it (including tool/env inheritance), and links it in the sidebar.
docs/tasks/monorepo.md— consolidated guide covering overview, config, path syntax (//, :), wildcards (...,*), tool/env inheritance, performance tuning, listing, and best practices.docs/tasks/task-configuration.md: Replaces detailed monorepo section with a brief intro and link toMonorepo Tasks.docs/configuration.md: Refines monorepo root wording, notes subdirectory tool inheritance, and updates link toMonorepo Tasks.docs/.vitepress/config.ts: AddsMonorepo Tasksto the Tasks sidebar.Written by Cursor Bugbot for commit 6caddb7. This will update automatically on new commits. Configure here.