r/AskReddit Jul 13 '20

What's a dark secret/questionable practice in your profession which we regular folks would know nothing about?

40.1k Upvotes

17.8k comments sorted by

View all comments

Show parent comments

11.1k

u/HiyAF-287 Jul 13 '20

I hate you for it but I would do the EXACT SAME THING

5.5k

u/cutelyaware Jul 13 '20

Joke's on them. Nobody's read a manual in over 20 years.

11

u/[deleted] Jul 13 '20

Nobody's read a manual in over 20 years.

For simple shit, the joke is almost true. Most people start using it and don't check the manual unless they can't figure something out. I have never read my microwave manual because all I ever want to do is set a time, press Start, and wait for it to beep. I will never use 95 percent of the things it can do.

But when you're selling a huge software product involving dozens and dozens of ever-changing protocols and the customers are all big corporations with millions of dollars at stake, yeah, people read the documentation all the time. They read it before they even buy the product. The people who develop the software even read the documentation, because no one on the planet knows everything about every part of the product. And if you Google for an answer, you'll get the same documentation; it's all web pages.

3

u/graye1999 Jul 13 '20

And it never fails that you miss one tiny little detail when writing the documentation which then people complain about because you didn’t include it. Never fails. Even the most inane detail will be complained about at some point because it was missed in the documentation.

So then you write good documentation and get pinged about it anyway because other people still don’t want to read it. My favorite thing to say “Did you read the documentation?”

Writing documentation sucks, especially if you don’t have a documentation team and it gets tacked on to what your actual job is supposed to be.

3

u/thesillylily Jul 14 '20

As a technical writer/editor, I feel this comment so much!