Hacker News new | ask | show | jobs
by ackfoo 2705 days ago
I often hear people proudly say, “I’m not technical...” but this is an anachronism. We live in a technical world now. If you’re not technical, you’re a dinosaur and you might as well die off. There’s no point pandering to dinosaurs.

The way you wrote your product page and app description is fascinating not because it was so oblique as to be completely meaningless, but because you appear to have been so thoroughly unaware of that fact.

This is an extremely common problem with technical documentation. We find pages and pages of description of frameworks and libraries created without simply answering the fundamental question, “What does this do?” And those pages could be easily replaced with one brief annotated example.

Technical people are often unaware that they have created a desert of meaning and substance.

1 comments

> There’s no point pandering to dinosaurs.

Err, yes there is, if they are willing to pay you money to simplify something they don't understand.

I agree that if you're not technical you're a dinosaur, but it turns out a good number of dinosaurs are still out there and they have money to spend. So why not cater to them while they're around?