Skip to content

Conversation

@ronaldtse
Copy link
Contributor

No description provided.

=== Schema change

This example shows schema changes made to a resource schema,
`support_resource_schema` across two editions: version 2 and version 4.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

two editions of the containing document:
note: The document edition and schema version are different scope and context.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@TRThurman I don't quite understand. This content directly comes from STEPmod at WG 12: data/resource_docs/fundamentals_of_product_description_and_support/resource.xml.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See this graphic at the document level:

image

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Right, the document changes are considered different from schema and mapping changes.

Our ELF 5005 only deals with schema and mapping changes because they pertain to EXPRESS.

It will not deal with document changes, that would have to be somewhere else.

Copy link

@TRThurman TRThurman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

minor nits.

@ronaldtse
Copy link
Contributor Author

ronaldtse commented Oct 15, 2025

@TRThurman one more question. Express Engine generates a structure like this:

<schema.changes>
<!-- Express Engine -->
<!--   5.2.7 (GIT eeng-5.2.7) -->
<!--   Steel Bank CL 2.5.8 (Unknown Bits) -->
<!-- Reference_Schema: GEOMETRY_SCHEMA -->
<!-- Path:   /Users/mulgogi/src/mn/iso-10303/schemas/resources/geometry_schema/geometry_schema_v11.exp -->
<!-- Trial_schema: GEOMETRY_SCHEMA -->
<!-- Path:   /Users/mulgogi/src/mn/iso-10303/schemas/resources/geometry_schema/geometry_schema_v13.exp -->


<schema.modifications>
<modified.object type="ENTITY" name="b_spline_curve_with_knots">
<description>
WHERE 'WR1' expression changed
</description>
</modified.object>

<modified.object type="ENTITY" name="rational_b_spline_surface">
<description>
<ul>
<li>DERIVE 'weights' type changed</li>
<li>DERIVE 'weights' expression changed</li>
</ul>
</description>
</modified.object>

<modified.object type="ENTITY" name="rational_b_spline_volume">
<description>
<ul>
<li>DERIVE 'weights' type changed</li>
<li>DERIVE 'weights' expression changed</li>
</ul>
</description>
</modified.object>

</schema.modifications>
</schema.changes>

Should we handle the <ul><li> constructs as independent descriptions? I'd rather have this than embed marked-up text inside when unnecessary.

If we do this, I'll update the change migration once more.

@TRThurman
Copy link

@TRThurman one more question. Express Engine generates a structure like this:
...

  • DERIVE 'weights' type changed
  • DERIVE 'weights' expression changed

</schema.modifications>
</schema.changes>


Should we handle the <ul><li> constructs as independent descriptions?
[TT] Yes!.

@ronaldtse
Copy link
Contributor Author

Excellent! I will also normalize "interfaced_items" because there are instances when there are more than one.

@ronaldtse
Copy link
Contributor Author

I also want to add a YAML schema for this in the annex, this way we can reference it for validation of files in the repositories.

I wonder where is the best place to put the schemas... maybe I put them in a new repository called "schemas ".

@TRThurman
Copy link

I also want to add a YAML schema for this in the annex, this way we can reference it for validation of files in the repositories.

I wonder where is the best place to put the schemas... maybe I put them in a new repository called "schemas ".

Maybe: 10303-support-schemata?

@ronaldtse ronaldtse force-pushed the rt-update-changes-spec branch from 4201db3 to 53e17b2 Compare October 15, 2025 08:28
@ronaldtse
Copy link
Contributor Author

ronaldtse commented Oct 15, 2025

Merging this first, new changes can come in a new PR. I want to get the "schemas" repo going. Thanks @TRThurman !

@ronaldtse ronaldtse merged commit 2942ad5 into main Oct 15, 2025
2 checks passed
@ronaldtse ronaldtse deleted the rt-update-changes-spec branch October 15, 2025 11:25
@ronaldtse
Copy link
Contributor Author

I have also applied these schemas to the ISO 10303 branch I was working on, now they all validate nicely in VSCode! (The schemas are automatically retrieved by VSCode)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants