Chapters 3 and 4 of my thesis: https://hal.archives-ouvertes.fr/tel-03515795 explain the data model of Software Heritage in a pretty accessible fashion, we should look at how much of these can be integrated to the documentation.
The repo of the thesis: https://github.com/seirl/thesis