Fix and add a few comments to schema_spec