From 95669466843c885d7d8890bc9e2e04c4b1e1d267 Mon Sep 17 00:00:00 2001
From: Ronald Tse <ronald.tse@ribose.com>
Date: Fri, 5 Apr 2024 13:42:51 +0800
Subject: [PATCH] chore: clean up iso document scheme content

---
 author/iso/ref/document-attributes.adoc   |  7 ++++++-
 author/iso/topics/markup.adoc             | 25 ++++++++++++++++++-----
 author/topics/output/font-management.adoc |  6 ++++--
 3 files changed, 30 insertions(+), 8 deletions(-)

diff --git a/author/iso/ref/document-attributes.adoc b/author/iso/ref/document-attributes.adoc
index cea9f3f6..b9ab598d 100644
--- a/author/iso/ref/document-attributes.adoc
+++ b/author/iso/ref/document-attributes.adoc
@@ -111,7 +111,12 @@ stage "`60`" (published), where a substage of "`60`" is assumed.
 Specifies the version of the ISO document specification that should be used in
 generating the Metanorma document.
  [added in https://github.com/metanorma/metanorma-iso/releases/tag/v2.7.1]
-Currently used only to specify the PDF layout.
++
+When omitted, the scheme to apply is inferred from the `:copyright-year:`
+document attribute, if set. Otherwise, the current default scheme is
+applied. [added in https://github.com/metanorma/metanorma-iso/releases/tag/v2.7.6].
++
+NOTE: Currently used only to specify the PDF layout.
 
 `2024`::: (default) Latest document layout as of 2024 (default)
 `2013`::: Document layout used from 2013 to early 2024.
diff --git a/author/iso/topics/markup.adoc b/author/iso/topics/markup.adoc
index 81fed0a3..ace07d0d 100644
--- a/author/iso/topics/markup.adoc
+++ b/author/iso/topics/markup.adoc
@@ -11,14 +11,23 @@ title: Metanorma for ISO markup
 
 Metanorma ISO supports multiple layouts of ISO documents through the
 `:document-scheme:` document attribute [added in https://github.com/metanorma/metanorma-iso/releases/tag/v2.7.1].
-If the `:document-scheme:` is not provided, the scheme to apply is inferred based on the `:copyright-year:` document attribute
-(without allowing for the month in which transition was made from one scheme to another -- which in any case was
-not always a clean transition historically) [added in https://github.com/metanorma/metanorma-iso/releases/tag/v2.7.6].
-If neither of those attributes is present, the current default is applied, `2024`.
+
+If the `:document-scheme:` is not provided, the scheme to apply is inferred
+solely based on the `:copyright-year:` document attribute.
+
+If neither of those attributes is present, the current default is applied.
+
+NOTE: The current default is `2024`.
+
+NOTE: Metanorma does not consider the month in selecting the actual document
+scheme because historically the transitions made from one scheme to another were
+according to a specific cut-off
+date [added in https://github.com/metanorma/metanorma-iso/releases/tag/v2.7.6].
 
 Specific instructions on using these layouts are described below.
 
-=== 2024 (latest)
+
+=== 2024 (latest and default)
 
 The following attributes should be set:
 
@@ -59,6 +68,12 @@ The following attributes should be set:
 
 * `:classification:` to set the UDC code(s).
 
+=== 1979
+
+The following attributes should be set:
+
+* `:classification:` to set the UDC code(s).
+
 === 1972
 
 The following attributes should be set:
diff --git a/author/topics/output/font-management.adoc b/author/topics/output/font-management.adoc
index 9ae6bf1a..9f5bbdb9 100644
--- a/author/topics/output/font-management.adoc
+++ b/author/topics/output/font-management.adoc
@@ -37,8 +37,10 @@ given the correct font files.
 == Automatic font installs with Fontist
 
 To make openly-licensed fonts available, Metanorma is integrated with
-https://github.com/fontist/fontist[Fontist] --
-a cross-platform font installer that helps you install publicly available fonts.
+https://github.com/fontist/fontist[Fontist].
+
+Fontist is a cross-platform font installer that helps you install publicly
+available fonts.
 
 If Metanorma detects that a necessary font is missing on your
 setup, it would automatically invoke Fontist to install the font.