Agreed.
I remember hearing very good talk from someone working on Django documentations that was very close to what you describe.
Cannot find the reference to the talk, but indeed this is how the documentation is organized:
https://docs.djangoproject.com/en/5.2/#how-the-documentation...