News for hackers. Stuff that matters.
Re:If someone’s having to read your docs, it’s not “simple” by yc-kraln on Monday June 07, 2021 @08:56AM (#27421993)
Yeah, communication is just about explaining what someone should understand. It's a simple concept, and as a result you can be sure that you only need to type a document once, and it's immediately understood. In fact, just like your comment, there isn't any way to misinterpret vague language, or have to cater to someone for whom English isn't their first language.

"Just" is a huge red-flag for me, not just in documentation, but also in effort estimation, requirements gathering, etc. It's the ??? between underpants gnomes and profit.

There are no comments on this comment yet.