metanorma / metanorma-iso

Metanorma processor for ISO standards
BSD 2-Clause "Simplified" License
13 stars 5 forks source link

Reference to Annex Clauses should be like "Clause A.2" and "A.2.3" #1145

Closed ronaldtse closed 4 months ago

ronaldtse commented 4 months ago

From @intelligent2013

According to ISO DIR 2, Annex clauses are "A.1", "B.1"... and they are considered "clause numbers":

Screenshot 2024-03-24 at 10 47 29 PM

Therefore they should be rendered as:

reference from Annex A sub-clause to another sub-clause

Originally posted by @Intelligent2013 in https://github.com/metanorma/metanorma-iso/issues/1134#issuecomment-2010589203

opoudjis commented 4 months ago

This change expressly does not apply to BSI.

ronaldtse commented 4 months ago

This change expressly does not apply to BSI.

How come?

opoudjis commented 4 months ago

This change expressly does not apply to BSI.

How come?

Because they said so:

https://www.bsigroup.com/globalassets/documents/standards/guide-to-standards/rules-for-structure-and-drafting-of-uk-standards-2022.pdf

Screenshot 2024-03-25 at 23 30 57

opoudjis commented 4 months ago

But no clear reason to have the list reference container be any different to a clause crossreference: Clause 7 a), not 7 a).

ronaldtse commented 4 months ago

@opoudjis but look at Figure 1, it is the exact same figure as ISO’s, where A.1 is a “Clause number”. Accompanied by the paragraph you quote which are just examples, I’d say it’s a bug in their guide. The proper way is ISO here. I’ll report this bug.

opoudjis commented 4 months ago

Until I hear from them that it's in error, I'm going with the example. The figure doesn't take priority over it.

ronaldtse commented 4 months ago

@opoudjis just change it now. I’ll email them. Let’s not waste our time in waiting.

opoudjis commented 4 months ago

I am not introducing errors, so the answer is no. The documents do not reflect the figure chart, they reflect the examples, and BSI are clearly not authoring "Clause A.1."

Screenshot 2024-03-26 at 11 28 56 Screenshot 2024-03-26 at 11 23 00

ronaldtse commented 4 months ago

Well then please keep track of Peter's reply. Please document the current behavior on the website since I can't keep track of this anymore.

opoudjis commented 4 months ago

Sure. If I get advice from BSI of a different default, that's what I'll implement.

opoudjis commented 3 months ago

BSI have replied, and they will stick with A.1, which is what they have been using to date.