Hacker News new | ask | show | jobs
by datadon 5442 days ago
If you can bear to get to the bottom of this list, there is a gem waiting for you:

"Don't sent me long documents. I like precision and concision. Say it on one page (or less)."

1 comments

I agree with some, disagree with others, but for me this is critical, I see a lot of documents, many of which are bloated with irrelevant material to try and deliberately make them seem weightier than they are...

For example a technical design document that reasonably contained less than a page of technical information plus a couple of useful diagrams padded out to 10 pages with user requirements that had been cut and paste from the original requirements document.

The design may or may not have been good, but teasing it out from within vaguely familiar material wasn't worth the effort for most readers, so it gets ignored, the dev thinking they have consensus starts implementing and is suprised by the ensuing shit-storm.

An email or post-it with a single paragraph or bulleted list of "here's what I'm going to do" would have been more effective

You missed the joke. He's spending 17 points to say that you should be concise. That's ironic.