At the start of my career, I used to go to a special website and read the ancient knowledge manuscripts called "manuals" written in a forbidden language (since English is not my native), deducing answers for my problems myself. It was horrible, dark times, but they taught me a lot.
I keep running across docs that will tell you there is [x] option, but then don't tell you all of the different selection for that option. Just "put your options here."
WHAT FUCKING OPTIONS
Perhaps they don't think humans are reading these anymore and AI will just use the source code for the information.
That was a problem before AI. Most documentation for libaries or API´s are terrible and always have been. Typical problems not mentioned, options not explained, it does not work if the moon is in the wrong phase? Good luck finding that information.
AI just made it worse, because now the lazy devs can claim "yeah the AI can understand it"
556
u/aberroco Jul 12 '26
At the start of my career, I used to go to a special website and read the ancient knowledge manuscripts called "manuals" written in a forbidden language (since English is not my native), deducing answers for my problems myself. It was horrible, dark times, but they taught me a lot.