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

Define the publication date as the approval date #22

Merged
merged 1 commit into from
Feb 9, 2024

Conversation

palemieux
Copy link
Member

@palemieux palemieux commented Dec 13, 2023

Closes #21

@palemieux palemieux requested a review from tbause December 13, 2023 05:59
Copy link

@palemieux palemieux requested review from SteveLLamb and removed request for tbause December 19, 2023 17:41
@FredWalls
Copy link

Can we provide some kind of notification for those who access the standards library if we decide to make this change? I'm sure it's possible for people to figure out what happened, but I think it would be beneficial to explain that documents before X date are indexed by publication date, documents after Y date are indexed by approval date, and documents between X and Y dates might be either.

@palemieux
Copy link
Member Author

@FredWalls To clarify: today all documents in the SMPTE document library are indexed using the approval date.

The change being proposed going forward is to change the date in the document designator, e.g. the 2023 in ST 2067-21:2023, from the publication date to the approval month and year, e.g. ST 2067-21:2022-11.

The date in the document designator will not change for existing document.

See sample at SMPTE/html-pub#190

@FredWalls
Copy link

@palemieux I'm kind of confused by your statement... when I click on the documents in the new library, the links come up as "published" followed by a date. I would consider this to be indexed by the publication date. But regardless, I think my point stands that whether we say that the change was to the document designator or something else, there needs to be a mention that a change was made to how it was derived.

@palemieux
Copy link
Member Author

I'm kind of confused by your statement... when I click on the documents in the new library, the links come up as "published" followed by a date.

Do you mean, for instance, Publication (1990-03-28) at https://pub.smpte.org/doc/eg1/ ? If so, Publication refers to the state of the document.

But regardless, I think my point stands that whether we say that the change was to the document designator or something else, there needs to be a mention that a change was made to how it was derived.

No disagreement.

@FredWalls
Copy link

Do you mean, for instance, Publication (1990-03-28) at https://pub.smpte.org/doc/eg1/ ? If so, Publication refers to the state of the document.

Ah, I understand what you're saying now. Notwithstanding I think it would be helpful to include the word "approved" next to that date as well if the tooling supports it. :)

@palemieux palemieux merged commit 4a75703 into main Feb 9, 2024
2 checks passed
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.

Identify versions of documents using the year-month approval date instead of the publication date
3 participants