I don't agree with it because while I think that it's theoretically correct, the words are too close together. To me "tutorial", "how to guide" and "explanation" are all practically synonyms. I know that when you think deeply about it, there are legitimate reasons for each category but it's just too close semantically that my brain can't see the difference. If I want to know how something works and I see "tutorial" and "how to guide" I have no idea what to click and I just click on the first thing.

I'm a big fan of Diátaxis and I'm using it to build documentation for Logdy: https://logdy.dev/docs/quick-start I'm curious how people see it and whether it's a useful way to document a software product, feel free to leave a comment. So far it proved to be an effective way to communicate how to use the product also through a series of blog posts that present common use cases. Defininitely recommend!

I'm a technical writer. Diátaxis is similar to DITA: https://www.oxygenxml.com/dita/1.3/specs/archSpec/base/infor...

On the other hand, systems like these might miss out on what users actually need. Diátaxis might work for a long time if technical documentation is only used in a documentation platform. However, if the same information could and should be used in more than one place—for example, in a UI, in a documentation portal, and in a mobile app—there might be need to break up information into smaller pieces in order to assemble them in different ways. This is known as 'content reuse', the practice of using the same content in multiple places. One approach on how to create and edit information for content reuse is described in the 'every page is page one' concept: https://everypageispageone.com/the-book/

If there's resources and time, I always recommend to do UX research at the very start of a project so that one doesn't later feel choked by a severely restricted information model. Nielsen/Norman have done a lot of research in this area and have interesting propositions on how to resolve issues around all of this, for example: https://www.nngroup.com/articles/information-foraging/#toc-w...

I'm pretty sure I was introduced to the concepts of proof by contradiction and by induction in the final year or two of high school, but that was fifty years ago in England.

Perhaps finding it confusing is a recent development.

Fellow boater here - I live on a Dutch Barge. Also awake at 0530 with creaking lines in this storm. Lovely lifestyle. We registered our new baby’s address as the boat on a birth certificate last week and had no problems. Good luck to any future researcher geocoding that! I expected a postcode to be required but it wasn’t :)