this post was submitted on 29 Aug 2023
822 points (96.1% liked)
Programmer Humor
19551 readers
1049 users here now
Welcome to Programmer Humor!
This is a place where you can post jokes, memes, humor, etc. related to programming!
For sharing awful code theres also Programming Horror.
Rules
- Keep content in english
- No advertisements
- Posts must be related to programming or programmer topics
founded 1 year ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
Yeah but have you seen some people's documentation? I get it's not a glamorous task but I've seen some stinkers before (a heap of properties and methods just thrown on a page with barely any description and no reasonable samples)
For real. More like 6 hours of debugging to figure out what they meant by the documentation you read in the first 5 minutes.
I copied and pasted some code from their own docs and it was missing required fields and those fields weren't clear or documented well. Going into their code helped more but still.
Also, the docs weren't written with me in mind. It's like if you were already familiar with it or a previous version because I swear I read it four times.