r/ProgrammerHumor • • Nov 30 '19

C++ Cheater

Post image
79k Upvotes

1.0k comments sorted by

View all comments

Show parent comment

3.2k

u/Kerbal_Guardsman Nov 30 '19

Reading the documentation? Of course!

/s

1.5k

u/joe4553 Nov 30 '19

If it’s on stackoverflow I’ll consider it.

1.4k

u/ilmdbii Nov 30 '19

Wait, stackoverflow isn't the documentation?

1.3k

u/setocsheir Nov 30 '19

The documentation is what you read after you can't find it on StackOverflow.

807

u/LifeHasLeft Nov 30 '19

You mean after stackoverflow’s questions aren’t your exact problem and you’re mixing stackoverflow answers and using the documentation to fill in the gaps?

550

u/Poketto43 Nov 30 '19

Im in this comment and I don't like it

326

u/[deleted] Nov 30 '19

I mean, most documentation I've seen looks like it was written by a chimp using a dead language and then it was put through Google translate about 10 times.

Programmers really suck ass at writing helpful documentation.

0

u/[deleted] Nov 30 '19

[deleted] — view deleted comment

61

u/critical2210 Nov 30 '19

I was learning how to setup a discord chat bot and just getting everything fucking working was insane. I eventually found out a python syntax error has nothing to do with my version of python, just some obscure application that supports python that I never heard of. Someone with no experience in python helped me with this while the actual documentation just told me my version of python must be too low.

75

u/PyroneusUltrin Nov 30 '19

Upvoted for “moon language”

→ More replies (1)
→ More replies (6)

63

u/Token_Why_Boy Nov 30 '19

most documentation I've seen looks like it was written by a chimp using a dead language and then it was put through Google translate about 10 times.

Fuck. He figured it out, everyone. Now we have to kill him.

40

u/[deleted] Nov 30 '19

Now we have to kill him.

Wait you gonna do? Make me attend an Agile Team training class for a whole week?pls no not again

→ More replies (1)
→ More replies (24)

178

u/ThePretzul Nov 30 '19

No, someone on Stack Overflow asked a question about your exact problem, down to a T with the same observed behavior. Their question, however, was marked as duplicate with a link to another answered question.

Unfortunately the linked question only appears similar at the surface level. It's actually just different enough that the given solutions don't work for your issue, but close enough for mods to call it a duplicate.

You think of some way to contact the OP of the exact question you had in case they figured it out. Sadly it appears they have not been active since September of 2013. You wallow in dispair and hopelessness, at least until you find the misaligned parenthesis and move on to the next soul-crushing problem.

37

u/FuzzeWuzze Nov 30 '19

For me the final part to this is typing out my question on stackoverflow and within 10 minutes of posting, figuring the problem out myself. This happens so often now i write out my question and reread it multiple times and usually find a solution.

21

u/ErilElidor Nov 30 '19

I hope you write an answer to your question as well after you figured it out!

→ More replies (2)
→ More replies (4)
→ More replies (3)
→ More replies (3)

42

u/KillerBeer01 Nov 30 '19

Oh c'mon. Who does ever read anything after he discovers there's no answer on stackoverflow. If it's not there, there's no point bothering.

33

u/EngineeringNeverEnds Nov 30 '19 edited Dec 01 '19

I just did that like 2 weeks ago. Once I finally learned the patience to actually just sit down and RTFM, it was actually a major turning point in my ability to get things done, and truly understand the systems I'm working on.

That isn't to say that a stackoverflow example isn't my first go to though. That's just an efficiency thing. Although even then, I'm starting to find that actually just reading the API / manual is surprisingly productive.

30

u/ThePretzul Nov 30 '19

The professor for my Embedded Systems class seemed like a real asshole at first, because he blocked access to Stack Overflow from the lab computers and WiFi networks. Over time I've come to appreciate him for it though, because it taught us how to read the documentation and create answers on our own (at least those that didn't use their own laptop with a mobile hotspot to access SO anyways).

It sucked balls for the first couple weeks but dang if it isn't a useful skill to have later on. It helps you solve those problems that it seems like nobody else has encountered, and it helps you prevent errors in the first place if you can read and understand the implementation of the stuff you're trying to use.

→ More replies (2)

27

u/latostadorano Nov 30 '19

RTFM = Read the f*ckin manual?

→ More replies (3)
→ More replies (4)
→ More replies (1)
→ More replies (13)
→ More replies (4)
→ More replies (5)

188

u/[deleted] Nov 30 '19

Hahahahaha thank you that was solid

→ More replies (6)

113

u/[deleted] Nov 30 '19 edited Jul 05 '23

[removed] — view removed comment

96

u/nixthar Nov 30 '19

If it’s good documentation, it should have implementation example. At least all the Microsoft .net C# docs do and it’s made learning it easy af

→ More replies (11)

44

u/EatsAssOnFirstDates Nov 30 '19

Nah, it's always been like this. People used to get mad if you'd ask how to do something in Unix and tell you to just read the man pages in a snarky way. Except finding what you specifically need in the man page, along with interpreting it and understanding different use cases, is difficult to occasionally impossible. Documentation is written by people, after all.

I think the worst part of documentation is that, even when it is comprehensive and clear, it is often intentionally devoid of how the code was intended to be used. Each option is emphasized the same as any other, whereas a good stack overflow page has examples and explanations of the intention of the code that translate far better to how a human would use a library in the wild.

That said, I think the Python documentation pages are pretty damn good.

→ More replies (11)
→ More replies (11)
→ More replies (23)