Documentation is hard. @meeroslav referred me to diataxis.fr, probably the 1st categorization of structuring technical docs that immediately made sense to me.

It approaches docs from these 4 angles.

here’s me paraphrasing some things to remember 🧵👇

#devrel @meeroslav Tutorials are learning oriented. They provide a path for the learner to follow, exercise and comprehend. They should not directly teach, but provide opportunities to learn. They are not intended to create experts, but create interest and lay the basis for exploring more.