Comment on I'm guilty of not reading the f..ing documentation
Smokeydope@lemmy.world 2 weeks ago
I volunteer as developer for a decade old open source project A sizable amount of my contribution is literally just cooking up decent documentation or re-writting old doc from the original module authors written close to a decade ago. Programmers as it turns out are very ‘eh, the code should explain itself to anyone with enough brains to look at it’ type of people who barely comment in the first place and so lost in the sauce of being a tech nerd instantly understanding all variables, functions, parameters, and syntax at very first glance at source code that they forgot the need for re-translation into regular human paragraphs for people who can barely navigate the command line… The seeming lack of college level english vocabulary/semantic proofreading abilities doesn’t help much either…
PoisonedPrisonPanda@discuss.tchncs.de 2 weeks ago
I cannot say how much I hate this.
even worse for old code where proper variable naming and underscores were forbidden. Impossible to get into someone else’s head.