Skip to content

Commit

Permalink
;doc: ISSUES
Browse files Browse the repository at this point in the history
  • Loading branch information
simonmichael committed Dec 13, 2023
1 parent b61e731 commit 766faf5
Showing 1 changed file with 9 additions and 40 deletions.
49 changes: 9 additions & 40 deletions doc/ISSUES.md
Original file line number Diff line number Diff line change
Expand Up @@ -137,49 +137,13 @@ The [trello board](http://trello.hledger.org) (trello.hledger.org) is an
old collection of wishlist items. This should probably be considered
deprecated.

## Prioritisation
## Prioritising

As of 2023 it's not too much of a problem knowing what's high priority to fix.
Still, <https://lostgarden.home.blog/2008/05/20/improving-bug-triage-with-user-pain/>
describes an interesting method of ranking issues by a single "User Pain" metric.
This would be interesting to try at least once for hledger's open issues; it might bring some benefit ?

Here is their system, in brief:

**Type (What type of bug is this?)**

7: Crash: Bug causes crash or data loss. Asserts in the Debug release.
6: Major usability: Impairs usability in key scenarios.
5: Minor usability: Impairs usability in secondary scenarios.
4: Balancing: Enables degenerate usage strategies that harm the experience.
3: Visual and Sound Polish: Aesthetic issues
2: Localization:
1: Documentation: A documentation issue

**Priority (How will those affected feel about the bug?)**

5: Blocking further progress on the daily build.
4: A User would return the product. Cannot RTM. The Team would hold the release for this bug.
3: A User would likely not purchase the product. Will show up in review. Clearly a noticeable issue.
2: A Pain – users won’t like this once they notice it. A moderate number of users won’t buy.
1: Nuisance – not a big deal but noticeable. Extremely unlikely to affect sales.

**Likelihood (Who will be affected by this bug)**

5: Will affect all users.
4: Will affect most users.
3: Will affect average number of users.
2: Will only affect a few users.
1: Will affect almost no one.

**User Pain = Type * Likelihood * Priority / Max Possible Score**

List all the active bugs in order of User Pain.
Developers check the Pain List daily and fix the highest pain bugs on the list.
If there are no bugs left above the current quality bar, they work on feature work.
When you do stumble upon a bug that will take more than a week to fix, flag it as a ‘killer’ bug (for special treatment).

What adaptation of the above might work for the hledger project ?
What adaptation of it might work for the hledger project ? Eg (WIP):

**Type (What type of bug is this?)**

Expand All @@ -189,8 +153,6 @@ What adaptation of the above might work for the hledger project ?
2: Installability or packaging issue.
1: Localisation or internationalisation issue.

WIP:

**Priority (How will those affected feel about the bug?)**

5: Blocking further progress on the daily build.
Expand All @@ -206,3 +168,10 @@ WIP:
3: Will affect average number of users.
2: Will only affect a few users.
1: Will affect almost no one.

**User Pain = Type * Likelihood * Priority / Max Possible Score**

- List all the active bugs in order of User Pain.
- Developers check the Pain List daily and fix the highest pain bugs on the list.
- If there are no bugs left above the current quality bar, they work on feature work.
- When you do stumble upon a bug that will take more than a week to fix, flag it as a ‘killer’ bug (for special treatment).

0 comments on commit 766faf5

Please sign in to comment.