docs: permission docs are missing
Metadata
Current evaluation
The login documentation omits valid --permission values; the maintainer confirmed the list is store-controlled and is awaiting a decision on a durable documentation source.
Suggested action: keep open
Reason: Maintainer @lengau confirmed the documentation gap and explained that valid permissions come from Charmhub's request schema, which can change independently of Charmcraft. The CLI currently describes --permission generically, and the unresolved choice between a dynamic reference, a link, or maintained values requires input from the Charmhub documentation owners.
Evaluated by: mr-cal-bot
Impact:
38
Quick Win:
13
Complexity:
45
Confidence:
94
Actionability:
64
Issue body
*Please describe the question or issue you're facing with "login - Charmcraft 3.5.3 documentation".*
Please provide a list of possible permissions that could be used on login. Or a link to the reference
---
*Reported from: https://documentation.ubuntu.com/charmcraft/stable/reference/commands/login/*
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha |
Impact:
38
Quick Win:
13
Complexity:
45
Confidence:
94
Actionability:
64
|
keep open | The login documentation omits valid --permission values; the maintainer confirmed the list is store-controlled and is awaiting a decision on a durable documentation source. | |
| qwen/qwen3.6-35b-a3b |
Impact:
30
Quick Win:
14
Complexity:
20
Confidence:
70
Actionability:
60
|
keep open | Missing documentation for valid --permission values in charmcraft login command. Maintainer acknowledged the gap and escalated to team for decision on how to document store-controlled permissions. | |
| qwen/qwen3.8-27b |
Impact:
35
Quick Win:
21
Staleness:
55
Complexity:
40
Confidence:
70
Support Request:
10
|
keep open | Charmcraft login reference docs lack a list of valid --permission values. A maintainer replied (2025-09-10) that permissions are store-controlled and the list can change, and asked @medubelko/@jahn-junior to weigh in on how to document them; no resolution yet. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
60
Complexity:
10
Confidence:
80
Support Request:
5
|
keep open | Request for documentation on available login permissions. Maintainer pointed to API docs but flagged maintenance challenges, tagging other maintainers for input on the best approach. Still awaiting resolution. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
75
Complexity:
30
Confidence:
65
Support Request:
10
|
needs triage | Request for documentation on available login permissions in Charmcraft. Currently stalled pending internal discussion on how to handle dynamically changing permissions from the store API. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
75
Complexity:
20
Confidence:
80
Support Request:
10
|
needs triage | Request for documentation on available login permissions in Charmcraft. A maintainer pointed to the API schema but noted maintenance challenges and requested input from other team members. Currently awaiting triage and decision. |
Update history
No update history recorded yet.
Related issues
No related issues found above the similarity threshold.