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

Handling non-standard "pre{STAGE}" identifiers #76

Closed
ronaldtse opened this issue Aug 28, 2022 · 9 comments · Fixed by #266
Closed

Handling non-standard "pre{STAGE}" identifiers #76

ronaldtse opened this issue Aug 28, 2022 · 9 comments · Fixed by #266
Assignees
Labels
enhancement New feature or request

Comments

@ronaldtse
Copy link
Contributor

As per metanorma/metanorma-iso#16

Occasionally ISO TCs will issue identifiers like this:

ISO/IEC preCD 29134

The current implementation in Metanorma is:

We need to decide how to handle this, e.g.

  • "ISO/IEC preCD 29135" => "ISO/IEC preCD 29135" (mark as draft: true, stage: "CD") or
  • "ISO/IEC preCD 29135" => "ISO/IEC CD.0 29135" (stage: "CD", iteration: 0)
@ronaldtse ronaldtse added the enhancement New feature or request label Aug 28, 2022
@ronaldtse ronaldtse moved this to 🆕 New in Metanorma Aug 29, 2022
@ronaldtse
Copy link
Contributor Author

It seems that "preCD" is a common IEC stage.

@mico
Copy link
Contributor

mico commented Sep 20, 2022

@ronaldtse in the description here "draft" format is "X.Y" and in the test asset here draft is the number "0.4".
Should we follow the same pattern, and how does this numbers affects rendered PubID and URN?

@ronaldtse
Copy link
Contributor Author

@mico in the future, we may have an iteration that acts like a version number, i.e. major.minor.

In any case, the test here does not make sense because it is PreCD3 but has draft version 0.4.

@mico
Copy link
Contributor

mico commented Apr 25, 2023

@ronaldtse reading the comments, I cannot figure out what we decided to do.
PreCD3 is draft version 0.4, so what is number "3" here?
Is preCD draft version 0?

@ronaldtse
Copy link
Contributor Author

I don’t have an answer. We should do what IEC does here.

@mico
Copy link
Contributor

mico commented Apr 26, 2023

I don’t have an answer. We should do what IEC does here.

@ronaldtse What I found about what IEC does with "preCD", is only "preCD" comes before "CD".
So it's another stage before CD
But I didn't find any "preCD" with numbers, like "preCD3".
I can just store "3" as some kind of stage number, without associating it with iteration.

@ronaldtse
Copy link
Contributor Author

I think we should treat "preCD" as a stage (this is an IEC stage), and "3" as the iteration number.

"preCD" means "Preparation of CD", and is a stage that comes before "CD".

@mico
Copy link
Contributor

mico commented Apr 27, 2023

@ronaldtse I'm trying to check if ISO/PreCD3 17301-1 is really exist.
How can we check if PreCD3 is existing stage?

And what are harmonized stages will be for "preCD"?

@opoudjis
Copy link

@mico you have just asked me this question.

https://www.metanorma.org/author/iec/ref/document-attributes/ explictly says we are currently ignoring preCD. And the lack of any harmonised stage equivalent is the reason why.

It is clear that the international harmonised stages are not truly applicable to IEC, and have only been designed for the simpler (and far clearer) ISO process.

I do not know any more than you do about this question, and the preCD stage is not documented in the authoritative IEC documentation at all ( https://www.iec.ch/system/files/2023-05/Consolidated_ISO-IEC_Part-1_IECSupplement_2023_redline.pdf https://www.iec.ch/standards-development/stages ) . I am going to just make an answer up, and you are just as capable of making an answer up as I am.

@ronaldtse is saying that he wants preCD treated as a separate stage. The stages are not actually used by IEC, so we are at liberty to assign our own intermediate numbers. There is precedent of intermediate numbers in substages (92, 93, 98, 99) and in stages (95): https://www.iso.org/stage-codes.html

.... So if we want a new stage between 20 and 30, and we are free to make up a stage number (which, in the absence of any guidance from IEC, we are), then use 29.

What's the alternative, after all? If we use either 20 or 30, then we are not deviating from ISO stages, but we are also not capturing PreCD as a distinct stage. Use 29, and if it blows up for whatever reason, we'll revisit the decision.

@mico mico closed this as completed in #266 Mar 29, 2024
@github-project-automation github-project-automation bot moved this from 🆕 New to ✅ Done in Metanorma Mar 29, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
Archived in project
Development

Successfully merging a pull request may close this issue.

3 participants