Giovanni Mascellani (@giomasce) commented about libs/vkd3d-shader/hlsl.h:
HLSL_ROW_MAJOR
};
+/* An HLSL data type. */ struct hlsl_type
Here and in other places the comment is quite obvious and doesn't help a lot. I would just add a comment when it adds something that was not evident before.