I keep seeing great languages plagued by the lack of documentation (or a pretty one, rather).
Biggest offender to me: #freepascal #pascal. With such a great compiler I am pissed off at the lack of organized documentation, it feels like an amateurish job. A lot of units are barely explained if at all (e.g. I double triple dare you to do OpenGL or X11 apps based on the wiki alone). It even lacks a good tutorial (which is why I give people https://castle-engine.io/modern_pascal as a resource)… FP’s wiki makes Tcler’s wiki look pristine. I’ve had the same symptom with Gambas and a lot of Lisp dialects. It’s even better when it’s a language on GitHub (or implementation/dialect a lot of times) with no useful info. Some other languages have documentation, but it either is or looks outdated which I believe is an impediment to adoption.
After I’ll be done with uni this September, I’ll try my best to do a proper and modern Pascal tutorial (and maybe do the same with a couple of other languages). I believe there’s an audience, especially in my country.
Alecu Ștefan-Iulian :verified: /
npub19u…65et0
2023-07-08 21:40:41
Author Public Key
npub19uke2u7xuvwdsrunnntg4m4y67rwa3n6dkn0wddpvtjllek9h87sv65et0Published at
2023-07-08 21:40:41Event JSON
{
"id": "7ec3b7338b1185fcdfa93c7f857f02b317212da2b0ddffa0303d374215198b48",
"pubkey": "2f2d9573c6e31cd80f939cd68aeea4d786eec67a6da6f735a162e5ffe6c5b9fd",
"created_at": 1688852441,
"kind": 1,
"tags": [
[
"t",
"pascal"
],
[
"t",
"freepascal"
],
[
"mostr",
"https://qoto.org/users/alecui/statuses/110680633572636028"
]
],
"content": "I keep seeing great languages plagued by the lack of documentation (or a pretty one, rather).\n\nBiggest offender to me: #freepascal #pascal. With such a great compiler I am pissed off at the lack of organized documentation, it feels like an amateurish job. A lot of units are barely explained if at all (e.g. I double triple dare you to do OpenGL or X11 apps based on the wiki alone). It even lacks a good tutorial (which is why I give people https://castle-engine.io/modern_pascal as a resource)… FP’s wiki makes Tcler’s wiki look pristine. I’ve had the same symptom with Gambas and a lot of Lisp dialects. It’s even better when it’s a language on GitHub (or implementation/dialect a lot of times) with no useful info. Some other languages have documentation, but it either is or looks outdated which I believe is an impediment to adoption.\n\nAfter I’ll be done with uni this September, I’ll try my best to do a proper and modern Pascal tutorial (and maybe do the same with a couple of other languages). I believe there’s an audience, especially in my country.",
"sig": "0491808fae40aedee33e6cd513e71c5c4d544e1783f0db0827424c1dc1c61016ad8cd7390820c982b98d8809df5bf28cfb78ef3d5498fad7768b634bc8d774ad"
}