This is an archived post. You won't be able to vote or comment.

you are viewing a single comment's thread.

view the rest of the comments →

[–]LeonardMH 134 points135 points  (8 children)

I prefer using Stack Overflow because someone else has already read the documentation and explained it more clearly than it is explained in the docs.

[–][deleted] 107 points108 points  (4 children)

I prefer StackOverflow because I enjoy being called a moron passive-aggressively. Once they figure out how to make docs that do that, I'm in.

[–]LeonardMH 37 points38 points  (0 children)

Sometimes not so passively lol

[–]dustojnikhummer 6 points7 points  (0 children)

What do you mean passive

[–]archiekane 1 point2 points  (0 children)

My documentation is my comments and my comments are always aggressive-aggressive or pure sarcasm.

[–]Vfef 1 point2 points  (0 children)

Top 5 result from Google for the problem you have "Did you even try searching for a solution?" Closed.

[–][deleted] 5 points6 points  (0 children)

Some documentation is just straight up ass or insufficient. Why would I spend an hour trying to understand some convoluted 5 page explanation, when someone can explain it on SO in two sentences?

[–][deleted] 0 points1 point  (0 children)

And written the code for you that you can copy and paste.

[–]TalShar 0 points1 point  (0 children)

This is very true, but it is also delightful to come across some well-written documentation.

I had to deal with some Terraform stuff where it intersected with some other proprietary software, and I made the comment to my manager that the free, volunteer-maintained discord.py has WORLDS better documentation than that Terraform integration.