this is quite confusing. i know we have a ticket to fixup some of these names, but until then, maybe some comment

(i.e. `get_descriptor_by_id` vs `get_class_by_id` and how one prefers static etc)