OMERO schema is inconsistent with description

[andy-sweet]

In v0.5.2 of the specification, the description of the OMERO metadata is inconsistent with the schema definition.

Specifically, the description says

Each dictionary in "channels" MUST contain the field "color", which is a string of 6 hexadecimal digits specifying the color of the channel in RGB format. Each dictionary in "channels" MUST contain the field "window", which is a dictionary describing the windowing of the channel.

but the schema does not label window or color as required properties.

This is strongly related to #192 which seems to be half complete because the schema was updated in #202 but the description update was not merged in #297.

I believe that ome/ngff-spec as of the latest commit also has this inconsistency.

To clarify, the issue here is the inconsistency and not what parts of the OMERO metadata should be required (though as someone that often thinks about visualization, I appreciate the presence of color and window when possible!). Therefore, I created a new issue to be be resolved instead of adding this as a comment to #192 or #297.

I think resolving #192 should resolve this issue too, perhaps by merging #297.

Also, I apologize if my permarefs are not quite accurate or if this issue should be created in ome/ngff-spec. I became a little lost in the various repos and submodules.

[lubianat]

@andy-sweet thank you for the issue! With regards the meta-issue of where it should be reported: yes, it is confusing. We should improve this documentation/workflow.