fix comments for required structs
add generated models as a baseline to compare upcoming gen changes