NeTEx icon indicating copy to clipboard operation
NeTEx copied to clipboard

Idea to actually make deprecated elements better visible

Open skinkie opened this issue 11 months ago • 3 comments

As we are all aware, deprecation of elements (let alone enumerations) is very poorly possible using XML Schema. This means that scanning existing documents for deprecated elements is troublesome because it is not programmatically available, just as comment from the XML Schema.

My proposal would be to resolve the situation for elements by introducing an attribute that attribute can have a default value for example -v2.0 if we have deprecated something in version 2.0. If this element is used in applications that regenerate their classes this will be automatically be added to the output (if defaults are enabled). We could also propose the attribute to have a fixed value in that case the validator using the newer schema will actively complain if the element is missing, and the document itself can be easily scanned for the attribute deprecated.

I would love to hear some feedback.

skinkie avatar Jan 08 '25 11:01 skinkie

We should discuss this next week.

ue71603 avatar Jan 08 '25 12:01 ue71603

That would be Ok for me. Could be named "deprecatedFrom" and have the corresponding fixed NeTEx version value.

Aurige avatar Jan 17 '25 13:01 Aurige

@trurlurl can you put this on your todo list?

ue71603 avatar Jan 17 '25 16:01 ue71603