Omar on Nostr: I believe comments are important and it's a no-no to accept that programmers won't ...
I believe comments are important and it's a no-no to accept that programmers won't maintain them (maybe naive of me but progs should be taught to treat them seriously if they aren't already?).
On an old game I started using _standardized_ FIXME comments to ensure they can be grepped. I still use that technique nowadays.
It's important IMHO to standardize them by e.g. subsystem rather than let everyone add their own flavor of "//!!HACK!!.
Published at
2024-11-21 16:22:56Event JSON
{
"id": "500f039c9aa1c36f8013478925394f2d344d8675687688563de85c38e36acfbf",
"pubkey": "5ca6389d23c47c23511623ee3af6dbe73fca356e83a50ad5a5ab31a7cda44ab5",
"created_at": 1732206176,
"kind": 1,
"tags": [
[
"e",
"8f622518899e0802481bf060806a534ad9dafa750adb2f14d4b962335415e327",
"wss://relay.mostr.pub",
"reply"
],
[
"imeta",
"url https://cdn.masto.host/mastodongamedevplace/media_attachments/files/113/521/859/574/756/004/original/0975a88da6b0d452.png",
"m image/png",
"dim 1473x1063",
"blurhash UAS6PlRjt7ay~qRjWBt7t7t7Rjof?bV@fQof"
],
[
"proxy",
"https://mastodon.gamedev.place/users/ocornut/statuses/113521863957164762",
"activitypub"
]
],
"content": "I believe comments are important and it's a no-no to accept that programmers won't maintain them (maybe naive of me but progs should be taught to treat them seriously if they aren't already?). \n\nOn an old game I started using _standardized_ FIXME comments to ensure they can be grepped. I still use that technique nowadays. \n\nIt's important IMHO to standardize them by e.g. subsystem rather than let everyone add their own flavor of \"//!!HACK!!.\n\nhttps://cdn.masto.host/mastodongamedevplace/media_attachments/files/113/521/859/574/756/004/original/0975a88da6b0d452.png",
"sig": "1e0f1b839e3ab4e00241299f26716670f2a6ec0fc0c4fe2069c0b21ffd288d6d8e917ce168324de27e4e93f2b000109d816b543ec56b36d006a088bd8f9015dc"
}