Unnumbered sections in ITU-WHO T-FG AI4H

[anermina]

ITU-WHO T-FG AI4H has two sections ("Abbreviations and acronyms" and "Executive summary") which are unnumbered but aren't preface sections. They appear after the ToC of the original document, right before the main (numbered) sections.

In case [%unnumbered] attribute is used, it only applies to the "Executive summary" section, since "Abbreviations and acronyms" require numbering by default.

In case [preface] attribute is used, it applies not only to these two sections but also to the "Introduction" section, which should be the first numbered section of the document.

What is the correct markup and behavior of Metanorma in this case?

[opoudjis]

I guess of the two, [%unnumbered] on Abbreviations and acronyms is the least bad option. I know why I'm insisting on the numbering; let me work out whether I can relax that constraint.

There is another alternative, which is to mark the section with [heading=Clause], so that it is titled Abbreviations, but not treated as an Abbreviations clause. But that's not addressing the Introductions issue.

We have introduced a change whereby the main section is detected automatically, as following preface clauses. The catch is that Introduction is automatically detected as a preface clause, unless a non-preface clause precedes it. If you mark Abbrevs as preface, Metanorma sees "introduction", and thinks "that's a preface clause too." Which normally it is.

If you do not want the Introduction treated as a preface clause, I suggest doing:

[heading=clause]
== Introduction

That forces the introduction to be treated as a main clause, and not belonging to the preface. Which is in fact what you want; if the Abbreviations clause was not there, the Introduction would still not be numbered.

[opoudjis]