Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adjustments for deprecation of @calendar #2473

Merged
merged 11 commits into from
Oct 21, 2023
Merged

Adjustments for deprecation of @calendar #2473

merged 11 commits into from
Oct 21, 2023

Conversation

raffazizzi
Copy link
Contributor

@raffazizzi raffazizzi commented Sep 12, 2023

To be discussed at the next council meeting because we need to decide whether to do Step 0 below which would cause a delay to the deprecation period.

Optional Step 0:

  • announce that there will be an upcoming change for ODD writers who want to include @calendar via att.datable, because:

Step 1:

  • make date, docDate, origDate, and time members of att.calendarSystem
  • remove @calendar from att.datable
  • define @calendar on the 40+ elements that it needs to be removed from and provide @validUntil on those attributes. This will make sure that the deprecation notice appears on the guidelines as well as in the generated schema.

Step 2:

  • complete process by removing @calendar from the elements.

@raffazizzi
Copy link
Contributor Author

During the 2023-10/13 council call we decided to:

  • proceed with Step 1 on this branch to be merged into dev when ready;
  • warn ODD users on TEI-L about the forthcoming change (likely coming in the November 23 release)
  • open new ticket to discuss deprecation of changes that affect ODD writing even when they don't directly affect the generated TEI schema. Another example can be found in the previous release (4.6.0): "The model.glossLike class (which contained altIdent, equiv, and gloss) has been renamed to model.identSynonyms."

raffazizzi and others added 6 commits October 13, 2023 15:00
…d time to att.calendarSystem. Added a calendar attribute with @validUntil to all the elements that it will be removed from.
Discovered that trying to delete @Calendar from att.datable (where it no longer exists) caused the attribute to be duplicated, not deleted. Not sure why, but the fast fix is to just stop deleting it. Of course that means these two schemas now have @Calendar when they shouldn’t. Probably need to add the 41 or so deletions needed to do so now.
... should not actually change any validation —
1. use default namespace instead of declaring tei: prefix and using it;
2. trim 2nd GI off @Ident iff needed.
@@ -1993,9 +1993,9 @@
<attDef ident="group" mode="delete"/>
</attList>
</classSpec>
<!-- We should be removing @calendar here!! -->
Copy link
Contributor Author

Choose a reason for hiding this comment

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

@sydb, this comment can go now, right?

Copy link
Member

Choose a reason for hiding this comment

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

Uhhh … do we not need to do what it says, first? I mean these exemplars are not supposed to have a @calendar attribute.

Copy link
Contributor Author

@raffazizzi raffazizzi Oct 16, 2023

Choose a reason for hiding this comment

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

But it's done AFAIK! The attribute is no longer in att.datable in this PR's code.

<attDef ident="calendar" mode="delete"/>
</attList>
</classSpec>
<!-- We should be removing @calendar here!! -->
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Ditto, this can go, @sydb ?

Copy link
Member

Choose a reason for hiding this comment

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

ditto.

Copy link
Member

@sydb sydb left a comment

Choose a reason for hiding this comment

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

Tests pass (including tei_jtei and tei_lite), and otherwise seems to look OK.

@sydb sydb added this to the Guidelines 4.7.0 milestone Oct 17, 2023
@npcole npcole merged commit e7874d2 into dev Oct 21, 2023
2 checks passed
@ebeshero ebeshero added this to the Guideline 4.7.0 milestone Nov 17, 2023
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.

None yet

4 participants