"Category": { "Mega feature": { "Sub-category": {}, } ... "Test category": {}, "Issue": {}, ... The hierarchical part is useful to properly order kapi content without the need to add multiple Sphinx markups to manually reorder the output inside the .rst files. (*) I would avoid hardcoding the fields/structures, as eventually we may need more flexibility to add fields and/or having some fields that are specific, for instance, to debugfs or sysfs. The python class it uses is at: https://gitlab.freedesktop.org/drm/igt-gpu-tools/-/blob/master/scripts/test_list.py?ref_type=heads and caller is at: https://gitlab.freedesktop.org/drm/igt-gpu-tools/-/blob/master/scripts/igt_doc.py?ref_type=heads Eventually you may find something useful there. If so, feel free to pick from it. Regards, Mauro