Opportunity to connect with the larger conversation about diataxis-documentation-framework

[saper]

I wish your comment had some hyperlinks to the concept you have mentioned, like, for example, to a Diátaxis, a pragmatic system for technical documentation writing Reddit thread.

I think Diátaxis favours being easy to the user over efficiency of documentation maintenance - being easy to the writer. In the tutorial section, for example, it promises nothing but blood, sweat and tears. I do not see much about re-use and modularity. This means, that if needed, the same information needs to be repeated in a slightly different way over and over. The core tenant of DITA seems to be trying manage this repetition.

I think nothing prevents someone to demonstrate how the toolkit provided by DITA is able to provide the documentation that is built according to the Diátaxis principles. if so desired. Personally I do not see any need to change this very repository with respect to that, though.