Ugh, I don't like that page and I have actually deleted it. It'll be gone soon.
replyThere 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.
Is there some way for me to be notified when you do? I don't see any RSS on your site.
replyThe 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).
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?
replyPlease post some kind of visible change notification (and something here) when you do!
replyIt 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!
reply