Some outdated documentation regarding `oil_type` input

[honzaflash]

In v0.12.2, oil type is now expected to be passed in as id or (id, title).

I've come across few places that still don't reflect that:

• OilTypeEnum docstring says "Either id or title can be input to OpenDriftModel" (models/opendrift/enums.py#L185)
• I think the schema might be outdated too: ModifyOilTypeJsonSchema.generate appears to allow "oneOf" id or title (models/opendrift/enums.py#L1521)

[honzaflash]

Hmmm, the plot thickens. I guess the ModifyOilTypeJsonSchema is actually what we want and the rest should change to accommodate that if possible.

[kthyng]

OilTypeEnum docstring says "Either id or title can be input to OpenDriftModel" (models/opendrift/enums.py#L185)

Agreed, the title can't be input.

I think the schema might be outdated too: ModifyOilTypeJsonSchema.generate appears to allow "oneOf" id or title

I think we have settled this over slack to leave as is for the moment? Though if you are feeling adventurous feel free to try to address Brian's comments from there to remove the "anyof" part (it is special custom code anyway) though then the mapping from id to name would have to still be present somewhere.

[honzaflash]

Yeah, actually now that I think about it (and understand the JSON schema format somewhat) it doesn't allow for the (id, title) even though the Pydantic models are ok with that.

Either way, I think the schema is good the way it is. And if the current implementation with the model accepting either id or the pair works, I'm fine with leaving it 👍

So only action item would be:

• Update OilTypeEnum docstring (models/opendrift/enums.py#L185)