← Back to issue list

Reference documentation about services in general

View original Github issue

Metadata

Project
craft-application
Number
#922
Type
issue
State
open
Author
lengau
Labels
Status: Triaged Type: Documentation
Created
Updated
Closed
—

Current evaluation

Triaged documentation work to broaden and rename the services reference, clarify what a service is, and make AppService secondary; the current app.rst remains AppService-only.

Suggested action: keep open

Reason: The maintainer-authored request clearly targets docs/reference/services/app.rst because it currently says only that AppService is the base class for services. Although #910 added conceptual information under the application structure explanation, app.rst and its toctree entry remain unchanged, so the requested reference documentation is still unresolved.

Evaluated by: mr-cal-bot

Impact: 38 Quick Win: 19 Complexity: 35 Confidence: 92 Actionability: 76

Issue body

### What needs to get done Expand and rename https://github.com/canonical/craft-application/blob/main/docs/reference/services/app.rst to better describe what a service is, making the `AppService` secondary ### Why it needs to get done This is currently unclear as `AppService` seems to be just another service.

Evaluation history

Date Model Scores Action Summary
stealth/space-bunny-alpha
Impact: 38
Quick Win: 19
Complexity: 35
Confidence: 92
Actionability: 76
keep open Triaged documentation work to broaden and rename the services reference, clarify what a service is, and make AppService secondary; the current app.rst remains AppService-only.
qwen/qwen3.6-35b-a3b
Impact: 35
Quick Win: 24
Complexity: 15
Confidence: 85
Actionability: 80
keep open Documentation task to expand and rename docs/reference/services/app.rst to describe services in general, making AppService secondary.
qwen/qwen3.8-27b
Impact: 30
Quick Win: 21
Staleness: 60
Complexity: 30
Confidence: 70
Support Request: 0
keep open Documentation task to expand and rename docs/reference/services/app.rst to better describe services in general, making AppService secondary. Triaged with Jira ticket CRAFT-4802, but no work done in 340 days.
qwen/qwen3.6-35b-a3b
Staleness: 80
Complexity: 20
Confidence: 85
Support Request: 0
keep open Documentation task to expand and rename service reference docs, clarifying the general service concept before AppService. Triaged but inactive for ~10 months.
qwen3.6-35b-a3b-mtp-q6
Staleness: 75
Complexity: 20
Confidence: 85
Support Request: 5
keep open Documentation task to expand and rename the services reference guide, clarifying the general service concept before detailing AppService. Currently triaged but inactive for 286 days with no active work.

Update history

No update history recorded yet.

Related work

  • Related To: craft-application#910 (confidence 95%)

    Added a high-level explanation of service responsibilities, but did not expand or rename the dedicated services reference page.

Related issues

No related issues found above the similarity threshold.