Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

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)."



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.




Consider applying for YC's Fall 2026 batch! Applications are open till July 27.

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: