| ▲ | 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). | ||