added comments to create_spec