← Back to issue list

docs: Document non-transitive equality behavior of DistroBase

View original Github issue

Metadata

Project
craft-platforms
Number
#232
Type
issue
State
open
Author
lengau
Labels
Created
Updated
Closed

Current evaluation

Documentation request to clarify non-transitive equality behavior in DistroBase.__eq__. Open 81 days with no labels or maintainer response.

Suggested action: needs triage

Reason: The issue is a valid documentation request from a maintainer (lengau) about the non-transitive equality behavior in DistroBase.__eq__, but it has no labels, no assignee, and no maintainer acknowledgment or comments. Per guidelines, unlabelled issues without maintainer response need triage before action is taken.

Impact: 30 Quick Win: 27.0 Staleness: 50 Complexity: 10 Confidence: 80 Support Request: 0

Issue body

The `DistroBase` class implements a custom `__eq__` method that supports partial version matching (e.g. comparing `"ubuntu@24.04"` to `"ubuntu@24.04.1"`). This leads to non-transitive equality: * `"24.04" == "24.04.1"` is `True`. * `"24.04" == "24.04.2"` is `True`. * `"24.04.1" == "24.04.2"` is `False`. We should document this behavior clearly in the class docstring and any relevant developer guides to prevent developers from making assumptions about transitivity in comparisons (which can affect sorting, collections, or search logic).

Evaluation history

Date Model Scores Action Summary
qwen3.6-35b-a3b-mtp-q6
Impact: 30
Quick Win: 27.0
Staleness: 50
Complexity: 10
Confidence: 80
Support Request: 0
needs triage Documentation request to clarify non-transitive equality behavior in DistroBase.__eq__. Open 81 days with no labels or maintainer response.
qwen/qwen3.6-35b-a3b
Staleness: 45
Complexity: 10
Confidence: 85
Support Request: 0
needs triage Request to document non-transitive equality behavior of the DistroBase class to prevent developer confusion regarding version comparisons, sorting, and collections. Currently unlabelled and awaiting maintainer triage.
qwen3.6-35b-a3b-mtp-q6
Staleness: 40
Complexity: 10
Confidence: 90
Support Request: 5
needs triage Request to document non-transitive equality behavior in DistroBase class docstring and guides to prevent developer confusion. Currently unlabelled and awaiting team review.
qwen3.6-35b-a3b-mtp-q6
Staleness: 5
Complexity: 10
Confidence: 90
Support Request: 0
needs triage Request to document non-transitive equality behavior in DistroBase to prevent developer assumptions about version comparisons. Currently unlabelled and awaiting triage.

Update history

No update history recorded yet.

Related issues

No related issues found above the similarity threshold.