← Back to issue list

Group related plugins

View original Github issue

Metadata

Project
craft-parts
Number
#1571
Type
issue
State
open
Author
steinbro
Labels
Status: Triaged
Created
Updated
Closed
—

Current evaluation

Group craft-parts plugins by language in docs (and optionally in source layout). Categorization agreed with a volunteer contributor who is preparing a PR; docs/plugins.rst toctree is still flat.

Suggested action: keep open

Reason: Maintainer triaged it ('Status: Triaged') and explicitly agreed to the contributor's proposed corrections — "All of your suggestions I'd agree with, including the last point about not creating a ROS-2 category just for colcon" — and GreyViperTooth replied "I'll get the PR submitted soon". Codebase inspection confirms the problem persists: docs/reference/plugins.rst is still one flat alphabetical toctree of 29 plugins with no section headings (grep for 'Multi-language' finds no matches). Impact is documentation discoverability, not correctness, and the optional source-code reorganization adds scope, so it should stay open until the PR lands.

Evaluated by: mr-cal-bot

Impact: 40 Quick Win: 24 Complexity: 30 Confidence: 80 Actionability: 85

Issue body

### What needs to get done This should at least be done for documentation, but could also be reflected in the organization of the source code. Proposed organization: 1. Built-in 1. dump 1. nil 1. Multi-language 1. ant 1. autotools 1. bazel 1. cmake 1. colcon 1. jlink 1. make 1. meson 1. qmake 1. scons 1. .NET 1. dotnet 1. dotnet_v2 1. Go 1. go 1. go_use 1. Java 1. gradle 1. java 1. maven 1. maven_use 1. JavaScript 1. npm 1. npm_use 1. Python 1. poetry 1. python 1. python_v2 1. uv 1. Ruby 1. ruby 1. Rust 1. cargo_use 1. rust ``` ### Why it needs to get done The number of plugins exceeds what's reasonable for a flat list. As they are sorted alphabetically, users can miss relevant plugins because they stop scrolling, e.g. choosing to use the Python plugin without realizing a uv plugin exists.

Evaluation history

Date Model Scores Action Summary
stealth/space-bunny-alpha
Impact: 40
Quick Win: 24
Complexity: 30
Confidence: 80
Actionability: 85
keep open Group craft-parts plugins by language in docs (and optionally in source layout). Categorization agreed with a volunteer contributor who is preparing a PR; docs/plugins.rst toctree is still flat.
stealth/space-bunny-alpha
Impact: 42
Quick Win: 27
Complexity: 27
Confidence: 94
Actionability: 88
keep open Group the growing plugin set by language in documentation; categorization is agreed, a contributor is preparing a PR, and source-code reorganization remains optional.
qwen/qwen3.6-35b-a3b
Impact: 45
Quick Win: 29
Complexity: 25
Confidence: 90
Actionability: 85
keep open Organize plugins into logical groups (Built-in, Multi-language, .NET, Go, Java, JavaScript, Python, Ruby, Rust) for documentation and source code to improve discoverability. Contributor actively implementing.
qwen/qwen3.8-27b
Impact: 35
Quick Win: 24
Staleness: 40
Complexity: 30
Confidence: 80
Support Request: 0
keep open Group plugins by language/ecosystem in docs and source code. Maintainer confirmed proposed groupings; contributor committed to a PR but none has been filed. Docs toctree remains a flat alphabetical list.
qwen/qwen3.6-35b-a3b
Staleness: 10
Complexity: 15
Confidence: 95
Support Request: 5
keep open Proposal to organize plugins into logical groups for documentation and source code. Maintainer confirmed contributor's proposed groupings; contributor is preparing a PR.
qwen3.6-35b-a3b-mtp-q6
Staleness: 45
Complexity: 20
Confidence: 85
Support Request: 0
needs triage Proposes categorizing plugins into language-specific groups for documentation and source code to improve discoverability. Currently unlabelled and awaiting maintainer assessment.

Update history

Date Change
updated

Related issues

Issue Project State Summary Similarity
#1650 docs: group plugins by language craft-parts open Groups plugins reference documentation into categories (Utility, Language-agnostic, Language-specific, Offline build plugins). Under review with 10 unresolved comments; 2 CI checks failing (lint/files, test-common minimum dependencies).
73%