Please post some kind of visible change notification (and something here) when you do!
It makes sense to me (I agree with it), but I also agree that it doesn't really deal with it. I look forward to whatever you're cooking!
We're currently in the process of restructuring our documentation and I'd be very interested in an early draft of this, fully understanding that caveat emptor. Is it published anywhere currently?
Is there some way for me to be notified when you do? I don't see any RSS on your site.
The docs I have built up are at times too technical for users and not detailed enough for developers. I am not sure if it's a skill issue on my part for an individual piece of text, a skill issue on my part in applying the principles outlined by Diataxis, or a fault in the framework itself (or its self-documentation).
Re:Diátaxis
by DanieleProcida on Thursday August 06, 2026 @10:32AM
(#49197228)
At your request, https://diataxis.fr/atom.xml
There is a real problem there, and that page doesn't do a good enough job of dealing with it. I have something cooking that is much, much better.