3 ms·
The docs should always be addressing a user need. That does not go away. Neither does Diataxis (the four quadrants of docs that you mentioned). I think this pos
by kaycebasques 2y ago
The docs should always be addressing a user need. That does not go away. Neither does Diataxis (the four quadrants of docs that you mentioned). I think this post is striking a chord because it's unsurfacing a blind spot in the two well-known strategies you mentioned. Everyone tries to make user-focused docs and many follow Diataxis, yet we still struggle to get stuff done with docs. Starting from the foundational viewpoint of the "docs should support decisions" might be a way to make docs more useful.