honestly, I do blame them for the state of the documentation because it's abnormally bad.
The amount of times I've been trying to understand behaviours of major areas of the network stack and it's completely undocumented and I have ended up reading the source code is far too high. It really is shocking how often fancy features get introduced with zero documentation and to use them you have to reverse engineer either the kernel or the one user space application that uses it.
In a clean C codebase, there are often aspects you have questions about or which aren't initially clear. The Linux kernel isn't a clean codebase; it's a pig sty.
And this isn't an inherent requirement of anything that the developers are building. The BSDs are *not like this*.
erincandescent 💜
npub1g6…ajrjv
2024-08-31 13:17:03 UTC
in reply to nevent1q…5jue
Author Public Key
npub1g6y83jgazvwv7dyjaxdhujq7sg5walvn0j273z5r2v8rwdh32pdqrajrjvSeen on
wss://relay.momostr.pinkPublished at
2024-08-31 13:17:03 UTCEvent JSON
{
"id": "f5e7bfb4cb1f14531e0d6463cfdf134ab58c905fae761ba2dcb4c9f28f1ffdf3",
"pubkey": "468878c91d131ccf3492e99b7e481e8228eefd937c95e88a83530e3736f1505a",
"created_at": 1725110223,
"kind": 1,
"tags": [
[
"p",
"c1812ca9433e5d31c5e35e9546d0f819d016ca6eabe98053daa6d40831179ec2"
],
[
"e",
"92afbeab1c99a3f82395ccc11d290e27f562853738274a02e0bba2e6b464fc86",
"",
"reply",
"c1812ca9433e5d31c5e35e9546d0f819d016ca6eabe98053daa6d40831179ec2"
],
[
"e",
"b853271c1960b8ee9ad9bbd5e5d71cf93dab8ec3348aabdd9d441d592923e6e6",
"",
"root",
"c1812ca9433e5d31c5e35e9546d0f819d016ca6eabe98053daa6d40831179ec2"
],
[
"proxy",
"https://akko.erincandescent.net/objects/88d8f8a9-c3e4-464a-8302-92cef9506e73",
"activitypub"
],
[
"L",
"pink.momostr"
],
[
"l",
"pink.momostr.activitypub:https://akko.erincandescent.net/objects/88d8f8a9-c3e4-464a-8302-92cef9506e73",
"pink.momostr"
],
[
"-"
]
],
"content": "honestly, I do blame them for the state of the documentation because it's abnormally bad.\n\nThe amount of times I've been trying to understand behaviours of major areas of the network stack and it's completely undocumented and I have ended up reading the source code is far too high. It really is shocking how often fancy features get introduced with zero documentation and to use them you have to reverse engineer either the kernel or the one user space application that uses it.\n\nIn a clean C codebase, there are often aspects you have questions about or which aren't initially clear. The Linux kernel isn't a clean codebase; it's a pig sty.\n\nAnd this isn't an inherent requirement of anything that the developers are building. The BSDs are *not like this*.",
"sig": "c9d079a8f3dfce766ffea69616f91468884b9f251c84f3739905692d8c8e80ea591a536093fd45412202343b9180ec3c4e3f43d2f18dc69a09829f94ae76aff0"
}