Hacker News new | ask | show | jobs
by ayewo 1129 days ago
I think more documentation teams need to know of the concept of Diataxis [1] so they can invest in the 4 different kinds of documentation developers turn to for help when picking up a new technology:

- tutorials;

- how-to guides;

- technical reference and;

- explanation.

1: https://diataxis.fr

2 comments

Thanks for this. This is something I kind of knew but would have been hard pressed to articulate, especially on the spot. Seeing it laid out like this is very useful.
This looks very nice and is something I have been searching for but didn't know existed. Thank you!
See also the C4 model "for visualising software architecture". https://c4model.com/