this post was submitted on 29 Aug 2023
826 points (96.1% liked)

Programmer Humor

19198 readers
1578 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

founded 1 year ago
MODERATORS
 
you are viewing a single comment's thread
view the rest of the comments
[–] [email protected] 19 points 1 year ago (2 children)

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)

[–] [email protected] 5 points 1 year ago

For real. More like 6 hours of debugging to figure out what they meant by the documentation you read in the first 5 minutes.

[–] [email protected] 3 points 1 year ago

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.