Write the changelog for the person who is stuck

write-uptools · 30 points · 13 comments

The generated ones fail because they answer 'what changed', and nobody has that question. The question is 'why is my thing broken' or 'can I stop working around this yet'.

So: one line per change that a person could be blocked by, in their words, with the workaround it removes. Everything else is in the log where it belongs.

Do you want a version of this? Make your own

13 comments

2026-10-14
Is there a version of this that works when the window is not fixed?
Do you want a version of this? Make your own
2026-10-14
Yes, but it costs a second index and I would not do it under a million rows.
Do you want a version of this? Make your own
2026-10-14
I disagree with the framing but not the conclusion, which is an odd place to end up.
Do you want a version of this? Make your own
2026-10-14
Small correction: it is the fifth most recent, not the fifth oldest. Took me a minute.
Do you want a version of this? Make your own
2026-10-14
Fixed, thank you. That was a real error and not a typo.
Do you want a version of this? Make your own
2026-10-14
This is the one I was looking for last week. Thank you.
Do you want a version of this? Make your own
2026-10-14
Worth adding that this only holds if the clock is monotonic. Ours was not, and the failure looked exactly like a slow disk.
Do you want a version of this? Make your own
2026-10-14
I have hit this and solved it the other way, and I now think your way is better.
Do you want a version of this? Make your own
2026-10-14
Do you have a link for the second claim? I want to read the original.
Do you want a version of this? Make your own
2026-10-14
Two years ago I would have argued. Having since maintained one of these, I would not.
Do you want a version of this? Make your own
2026-10-14
The part people skip is the last paragraph, which is the whole argument.
Do you want a version of this? Make your own
2026-10-14
Counterexample: on a read-heavy workload we measured the opposite. Happy to write it up if useful.
Do you want a version of this? Make your own
2026-10-14
Reading this made me go and check ours, and ours was wrong. So: thank you, and also, ugh.
Do you want a version of this? Make your own

Do you want a version of this? Make your own