Developer docs: Architecture explanation
Metadata
Current evaluation
Developer docs enhancement to explain the purpose of commands, services, and what the application should/shouldn't do. Triaged by maintainer; a structure-of-a-craft-app explanation page now exists in docs/explanation covering Application, Commands, and Services.
Suggested action: keep open
Reason: The issue is triaged (Status: Triaged, Type: Documentation/Enhancement) and the requested content appears largely addressed by docs/explanation/structure-of-a-craft-app.rst, which explains the Application, Commands, and Services and their responsibilities. However, the issue also asks for 'what the application should/shouldn't do' and per-command/per-service purpose, which may not be fully covered, so it should stay open for a maintainer to confirm scope before closing.
Issue body
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.8-27b |
Impact:
40
Quick Win:
28.0
Staleness:
55
Complexity:
30
Confidence:
60
Support Request:
0
|
keep open | Developer docs enhancement to explain the purpose of commands, services, and what the application should/shouldn't do. Triaged by maintainer; a structure-of-a-craft-app explanation page now exists in docs/explanation covering Application, Commands, and Services. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
85
Complexity:
30
Confidence:
80
Support Request:
10
|
keep open | Documentation enhancement to explain command and service purposes, plus application scope. Triaged but inactive for over a year, awaiting implementation. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
75
Complexity:
20
Confidence:
85
Support Request:
5
|
keep open | Documentation enhancement to clarify command and service purposes and application boundaries. Triaged by a maintainer but inactive for over ten months. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
70
Complexity:
30
Confidence:
75
Support Request:
0
|
keep open | Document architecture, command and service purposes, and application boundaries to address recurring design confusion. Currently triaged as a documentation enhancement but inactive for 286 days with no assignee or next steps. |
Update history
No update history recorded yet.
Related work
-
Likely Fixed By:
craft-application#910
(confidence 65%)
Commit 2f03a3bc 'docs: add application structure explanation (#910)' added docs/explanation/structure-of-a-craft-app.rst covering Application, Commands, and Services, matching the issue's core ask.
Related issues
No related issues found above the similarity threshold.