[kaycebasques]

Yes, we also mostly landed on a section approach (tutorial in one section, explanation in another, etc.) versus page approach (tutorial on one page, explanation on another page, etc.). Perhaps the Diataxis site itself should provide guidance on when you might be better off with a section approach versus a page approach, or some other approach entirely. The idea of modes is very subtle. I don't think most Diataxis readers immediately grok it. I think many people assume that the site is recommending a page approach.

What I'm hinting at re: homepages and READMEs is that there's an art and science to index pages (I think of both READMEs and homepages as types of index pages). I'm not convinced that you can boil down index pages to just a mix of explanations, tutorials, references, and guides. I think it's a different type of content that's not really well-represented on the Diataxis map.