this post was submitted on 29 Aug 2023
730 points (96.0% liked)

Programmer Humor

19544 readers
639 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
Feyter@programming.dev
anzo@programming.dev
BurningTurtle@programming.dev
pylapp@programming.dev
730
I know, I know, but this revision compiles (sh.itjust.works)
submitted 1 year ago by casualhippo@sh.itjust.works to c/programmer_humor@programming.dev
19 comments fedilink hide all child comments
 
you are viewing a single comment's thread
view the rest of the comments
[โ€“] Anonymousllama@lemmy.world 15 points 1 year ago (1 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)

[โ€“] lobut@lemmy.ca 2 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.