←back to thread

Focus on decisions, not tasks

(technicalwriting.dev)
293 points kaycebasques | 1 comments | | HN request time: 0.198s | source
Show context
nicbou ◴[] No.41886247[source]
I write about German bureaucracy, and I wholeheartedly agree with your approach.

Most of my guides start with: what this is, who needs to do this, why you need to do this. If you don’t confirm that people are on the right page doing the right thing for the right reasons, they can go really far in the wrong direction.

Most government websites don’t explain any of this. They just tell you what they want from you to complete the part of the task that concerns them. They don’t bother to treat the task as part of a bigger decision. They just assume that you are here because you know what you are doing.

replies(3): >>41887953 #>>41888655 #>>41888966 #
kaycebasques ◴[] No.41888966[source]
> If you don’t confirm that people are on the right page doing the right thing for the right reasons

Based on this comment I think you would appreciate Every Page Is Page One a lot. The basic idea is that people can and will land on any random page of your docs site, so every page needs to quickly ground them and make it super easy for them decide whether they're on the right path or no. That's where the book title is coming from. Literally any page of your site might be page one for a user.

replies(1): >>41890717 #
1. nicbou ◴[] No.41890717[source]
That’s exactly how I design my content! I work really hard on making sure that every entry point leads to the right path. It’s surprisingly challenging.

Thank you for the book recommendation. I will give it a look.