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

Linkify stability policy #941

Merged
merged 2 commits into from
Nov 18, 2024
Merged

Linkify stability policy #941

merged 2 commits into from
Nov 18, 2024

Conversation

aphillips
Copy link
Member

Fixes #930

Also clarifies that [!IMPORANT] blocks are normative.

Fixes #930 

Also clarifies that [!IMPORANT] blocks are normative.
@aphillips aphillips added fast-track Non-spec editorial changes, etc. editorial specification LDML46.1 MF2.0 Draft Candidate labels Nov 16, 2024
Copy link
Member

@macchiati macchiati left a comment

Choose a reason for hiding this comment

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

Just one item

Updates to this specification will not remove any options or option values
defined in the default registry.
Updates to this specification will not remove any _options_ or _option_ values
defined in the default function registry.

Copy link
Member

Choose a reason for hiding this comment

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

One additional item. We should add the following clause for clarity.

Suggested change
Updates to this specification may **deprecate** _functions_, _options_, and _operands_ defined in the default registry, as is standard practice in Unicode specifications. This is to indicate that the use of those _functions_, _options_, or _operands_ is discouraged. However, they are never removed, and implementations can continue to support them.

Copy link
Member Author

Choose a reason for hiding this comment

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

We already say this (line 146), except we don't mention operands in the stability policy and, of course, it's much less explanatory. Note that the stability policy is about what we won't do.

Making this change would be normative and require WG consensus, so I'll change the tags and remove fast-track until we discuss Monday.

Copy link
Member

Choose a reason for hiding this comment

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

Sounds good

Copy link
Collaborator

Choose a reason for hiding this comment

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

Eh, this is a completely separate change from this PR. It really should be handled separately, but we're going to feature-creep it into this same change once again, yes?

Something like this was previously discussed here: #883 (comment), and the spec text already includes this, which is in an [!IMPORTANT] block and therefore normative:

> - Future versions may deprecate (but not remove) keywords, functions, options, or option values.

Copy link
Member Author

Choose a reason for hiding this comment

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

Eh, this is a completely separate change from this PR. It really should be handled separately, but we're going to feature-creep it into this same change once again, yes?

Under normal circumstances, I would insist on it. But I'm hoping to be done tomorrow.

@aphillips aphillips added Agenda+ Requested for upcoming teleconference and removed fast-track Non-spec editorial changes, etc. labels Nov 17, 2024
spec/README.md Outdated Show resolved Hide resolved
@aphillips aphillips requested a review from eemeli November 17, 2024 15:02
Copy link
Collaborator

@eemeli eemeli left a comment

Choose a reason for hiding this comment

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

The current text looks good. I don't think the added deprecation item is necessary, as we already mention it later in the text. If there's something missing from that (such as explicitly allowing for deprecating operands), it ought to be modified in place.

@aphillips aphillips merged commit 9f78316 into main Nov 18, 2024
1 check passed
@aphillips aphillips deleted the aphillips-linkfy-stability branch November 18, 2024 18:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Agenda+ Requested for upcoming teleconference editorial LDML46.1 MF2.0 Draft Candidate specification
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Linkify the stability policy
3 participants