4 ms·

Something I've wondered when writing my own changelogs: What determines whether an issue is categorized as "fixed," "addressed," or "resolved"?

labria 4y ago
I'm pretty sure all of them mean the exact same thing, they just alternate for the notes to be less repetitive.
culturestate 4y ago
> What determines whether an issue is categorized as "fixed," "addressed," or "resolved"? I mostly use them interchangeably and just pick whichever one feels better in that particular sentence at that particular part of the changelog. The only real exception is when I've fixed one specific expression of a problem but I think there are probably still edge cases where it might pop up again. I deliberately mark those as "addressed" for my own sanity.
savoytruffle 4y ago
In recent years the terminology on Apple update notes is very inconsistent so I wouldn't read much into it except that nobody is paying much attention to it.
layer8 4y ago
You use “addressed” when you’re not entirely sure that it’s completely fixed. You use “resolved” when you removed the feature instead of fixing it. ;)
memco 4y ago
These days I gravitate towards “improved” or “enhanced” handling or support for something to avoid unbounded certainty about the issue.
wrldos 4y ago
I only ever write it as defect / feature prefixed. I never write the resolution as I am fallible!
koen_hendriks 4y ago
It's why I prefer to use a standard like https://keepachangelog.com https://keepachangelog.com
lazzlazzlazz 4y ago
Very similar but subtly different in my mind. - Fixed: something was broken, and it has been repaired. - Addressed: there was an issue, and we've responded to it maybe with a workaround, improving docs, maybe by saying we won't fix it/it wasn't broken. - Resolved: something wasn't working, and now it works. Maybe there were fixes, and maybe there were workarounds. But it works now.

labria 4y ago

I'm pretty sure all of them mean the exact same thing, they just alternate for the notes to be less repetitive.

culturestate 4y ago

> What determines whether an issue is categorized as "fixed," "addressed," or "resolved"? I mostly use them interchangeably and just pick whichever one feels better in that particular sentence at that particular part of the changelog. The only real exception is when I've fixed one specific expression of a problem but I think there are probably still edge cases where it might pop up again. I deliberately mark those as "addressed" for my own sanity.

savoytruffle 4y ago

In recent years the terminology on Apple update notes is very inconsistent so I wouldn't read much into it except that nobody is paying much attention to it.

layer8 4y ago

You use “addressed” when you’re not entirely sure that it’s completely fixed. You use “resolved” when you removed the feature instead of fixing it. ;)

memco 4y ago

These days I gravitate towards “improved” or “enhanced” handling or support for something to avoid unbounded certainty about the issue.

wrldos 4y ago

I only ever write it as defect / feature prefixed. I never write the resolution as I am fallible!

koen_hendriks 4y ago

It's why I prefer to use a standard like https://keepachangelog.com https://keepachangelog.com

lazzlazzlazz 4y ago

Very similar but subtly different in my mind. - Fixed: something was broken, and it has been repaired. - Addressed: there was an issue, and we've responded to it maybe with a workaround, improving docs, maybe by saying we won't fix it/it wasn't broken. - Resolved: something wasn't working, and now it works. Maybe there were fixes, and maybe there were workarounds. But it works now.