docs: for the autotools plugin relevant flags are not described, e.g. disable_parallel
Metadata
Current evaluation
Docs gap: the Autotools plugin reference does not document the disable-parallel part property or its effect on make -j. Triaged; fix PR #1631 is open with unresolved review comments and failing CI.
Suggested action: keep open
Reason: Verified the gap still exists at HEAD: docs/common/craft-parts/reference/plugins/autotools_plugin.rst only documents autotools_bootstrap_parameters and autotools_configure_parameters, and its 'How it works' step 3 just says 'Call make to build', while autotools_plugin.py:133-134 emits plain 'make' or 'make -j{parallel_build_count}' based on disable_parallel. The property is only generically documented via PartSpec in part_properties.rst, so the plugin-specific behavior is genuinely undocumented. The issue is labelled Triaged/Documentation/Bug and a contributor opened PR #1631 ('docs: document autotools disable-parallel key') which is still open — approved but with two unresolved review comments and three failing CI jobs — so the issue is valid and not yet resolved. Impact is modest (docs clarity, not a functional bug) and the fix is a short docstring/section plus changelog entry.
Evaluated by: mr-cal-bot
Issue body
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha |
Impact:
28
Quick Win:
21
Complexity:
8
Confidence:
87
Actionability:
82
|
keep open | Docs gap: the Autotools plugin reference does not document the disable-parallel part property or its effect on make -j. Triaged; fix PR #1631 is open with unresolved review comments and failing CI. | |
| stealth/space-bunny-alpha |
Impact:
30
Quick Win:
25
Complexity:
12
Confidence:
97
Actionability:
95
|
keep open | Autotools plugin documentation omits disable-parallel and its effect on parallel builds; the issue is triaged, but fix PR #1631 remains open with unresolved comments and failing CI. | |
| qwen3.6-35b-a3b-mtp-q6 |
Impact:
45
Quick Win:
38
Staleness:
25
Complexity:
15
Confidence:
85
Support Request:
10
|
keep open | Documentation missing for autotools plugin's disable_parallel option. PR #1631 opened to address this, currently under review with unresolved comments. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
10
Complexity:
5
Confidence:
90
Support Request:
10
|
keep open | Documentation missing for the disable_parallel flag in the autotools plugin. The issue is triaged, acknowledged by maintainers, and a PR has been opened to add the missing documentation. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
15
Complexity:
15
Confidence:
90
Support Request:
10
|
keep open | Documentation missing for autotools plugin flags like disable_parallel. Issue triaged, transferred to craft-parts, and a PR has been opened to add the missing descriptions. |
Update history
No update history recorded yet.
Related work
-
Related To:
craft-parts#1167
(confidence 92%)
Merged PR that added disable_parallel to the autotools plugin (craft_parts/plugins/autotools_plugin.py), the feature whose documentation is now missing.
-
Likely Fixed By:
craft-parts#1631
(confidence 90%)
Open PR adding docs for the autotools disable-parallel key and parallel make behavior plus a changelog entry; approved but blocked on review comments and CI.
-
Related To:
craft-parts#1242
(confidence 85%)
Open, low-priority request to make the make plugin honor disable-parallel; adjacent documentation/behavior gap in the same parallel-build area.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #1631 docs: document autotools disable-parallel key | craft-parts | open | Docs-only PR adding the autotools `disable-parallel` key and a parallel-build note plus a changelog entry to the Autotools plugin reference. Approved by one reviewer but 2 unresolved comments remain; author agreed to revert the "How it works" line and awaits maintainer guidance; 3 CI checks failing. | |
| #1242 make plugin: Support `disable-parallel` parameter | craft-parts | open | Enhancement: make plugin should honor the disable-parallel part property (currently always emits make -j"N"). Filed by a maintainer, labeled Triaged/Enhancement, and explicitly deferred as "extremely low priority" until a real-world non-parallel-build use case is supplied; autotools already has it via PR #1167. | |
| #1167 feat: add parallel parameter to autotools plugin | craft-parts | merged | Merged #1167 as commit 7dfd1bf7, adding disable_parallel to the Autotools plugin so builds can omit make -j and addressing #1069. |