Dear fellow developers: If you call something a "#changelog", make sure it really is a changelog, i.e. a document written for users that lists the changes w/o technobabble.
A list of commit descriptions is NOT a changelog! Commit descriptions by nature contain technobabble and are generally useless to the users.
You can still display a list of commits if you like, but then be honest and call it "list of commits", not "changelog".
#development #PSA #rant #VCS
Wuzzy
npub1lh…tc95t
2025-08-23 07:00:32 UTC
Author Public Key
npub1lhgfp5cu2twzmydrxlpv2wkygznqn09qqc3luq70uscw25awq8cqmtc95tSeen on
wss://relay.mostr.pubPublished at
2025-08-23 07:00:32 UTCEvent JSON
{
"id": "760a2a0a27f9382d1b60c31681a5c4dbb535d4c726db2c374f4e5d90e79a6029",
"pubkey": "fdd090d31c52dc2d91a337c2c53ac440a609bca00623fe03cfe430e553ae01f0",
"created_at": 1755932432,
"kind": 1,
"tags": [
[
"t",
"changelog"
],
[
"t",
"development"
],
[
"t",
"psa"
],
[
"t",
"rant"
],
[
"t",
"vcs"
],
[
"proxy",
"https://cyberplace.social/users/Wuzzy/statuses/115076787885556969",
"activitypub"
],
[
"client",
"Mostr",
"31990:6be38f8c63df7dbf84db7ec4a6e6fbbd8d19dca3b980efad18585c46f04b26f9:mostr",
"wss://relay.mostr.pub"
]
],
"content": "Dear fellow developers: If you call something a \"#changelog\", make sure it really is a changelog, i.e. a document written for users that lists the changes w/o technobabble.\n\nA list of commit descriptions is NOT a changelog! Commit descriptions by nature contain technobabble and are generally useless to the users.\n\nYou can still display a list of commits if you like, but then be honest and call it \"list of commits\", not \"changelog\".\n\n#development #PSA #rant #VCS",
"sig": "7b2a55c13e9529e856de3e372047e349315e74466796bfb690117eac17ea4c5b8e4e658d43f1d22e5194646698bd7700ebd5eac39d93ca7ffd18c05b3c8258d9"
}