Remix.run Logo
lwhsiao 14 hours ago

You would like the Diátaxis framework: https://diataxis.fr/

That is the structure they (any many others) are following :).

anordin95 8 hours ago | parent [-]

I know it and do like it! Even for those that follow Diataxis, in my experience the "Explanation" sections are often lacking, especially compared to the "How-To" or "Tutorial" ones.

Python is one example that comes to mind. They do have explanations here: https://docs.python.org/3/howto/index.html. And, to be fair, they are generally excellent in my opinion! But they're far from front and center and there's much less overall content compared to the other Diataxis types I think (granted, I haven't rigorously checked).