This seems to me like it belongs on the _CKAN Code Architecture_ page, with maybe just a reference to it here. This is documentation about CKAN core for core devs.