←back to thread

Focus on decisions, not tasks

(technicalwriting.dev)
293 points kaycebasques | 1 comments | 18 Oct 24 17:58 UTC | HN request time: 0.248s | source
Show context
kaycebasques ◴[18 Oct 24 20:45 UTC] No.41883333[source]▶
Over on r/technicalwriting I'm having a debate with someone regarding whether this is a general principle or not. To be clear, I have no idea how niche or widespread this problem, is. My hunch is that it's a brilliant insight that applies to technical writing in many industries. For now it's just an idea that I think deserves a lot more thought and discussion.
replies(1): >>41887473 #
1. bbor ◴[19 Oct 24 12:47 UTC] No.41887473[source]▶
I’d say it’s an interesting phrasing of a general principle, namely the four types of technical documentation. “Preparing people for decisions” is the first and third types (references and explanations) and “guiding people through tasks” is the second and fourth types (instructions and tutorials). IMO!