News for hackers. Stuff that matters.
Re:Peter Naur's view of programming by solatic on Thursday February 04, 2021 @01:46PM (#26028469)
Reading and writing scale in theory. They require an organization staffed with people who are strong readers and writers. Unfortunately, many people, especially those forced into remote work during the pandemic, are not. They will not read through explicit, clear, but long documentation; they will not respond by writing questions of their own, and will often fail at writing explicit and clear documentation of their own.

You are who you hire.

Re:Peter Naur's view of programming by rorykoehler on Thursday February 04, 2021 @11:38PM (#26033186)
....They won't do their job.
Re:Peter Naur's view of programming by simiones on Friday February 05, 2021 @05:21AM (#26034807)
Their job is not to write docs, it's to produce a product. The docs are a possible tool towards that goal, but there are others, with different trade-offs - such as in-person trainings.

It is fairly obvious that most of the industry believes the opposite from you here - thorough docs are an extremely expensive way of achieving good context, and as such are usually replaced with training sessions, which seem to fit most people better up to some point.

Re:Peter Naur's view of programming by rorykoehler on Friday February 05, 2021 @05:35AM (#26034890)
You can’t do in-person training properly without docs. It’s not an either or choice.