metanorma-ieee 0.0.2 → 0.0.3

data/lib/metanorma/ieee/boilerplate.xml

@@ -243,26 +243,61 @@
     </clause>
     <clause id="boilerplate-participants">
       <title>Participants</title>
+      <clause id="boilerplate-participants-wg">
         <p>At the time this draft {{ doctype }} was completed, the {{ working_group }} Working Group had the following membership:</p>
-        <p align="center" type="officeholder"><strong>{{ wg_members["chair"] }}</strong>, <em>Chair</em></p>
-        <p align="center" type="officeholder"><strong>{{ wg_members["vice-chair"] }}</strong>, <em>Vice Chair</em></p>
-        {% if wg_members["secretary"] %}<p align="center" type="officeholder"><strong>{{ wg_members["secretary"] }}</strong>, <em>Secretary</em></p>{% endif %}
-        {% for m in wg_members["members"] %}
-        <p type="officemember">{{ m }}</p>
-        {% endfor %}
-        <p>The following members of the {{ balloting_group }} Standards Association balloting group voted on this {{ doctype }}. Balloters may have voted for approval, disapproval, or abstention.</p>
-        {% for m in balloting_group_members %}
-        <p type="officemember">{{ m }}</p>
-        {% endfor %}
-        <p>When the IEEE SA Standards Board approved this {{ doctype }} on {{ confirmed_date }}, it had the following membership:</p>
-        <p align="center" type="officeholder"><strong>{{ std_board["chair"] }}</strong>, <em>Chair</em></p>
-        <p align="center" type="officeholder"><strong>{{ std_board["vice-chair"] }}</strong>, <em>Vice Chair</em></p>
-        <p align="center" type="officeholder"><strong>{{ std_board["past-chair"] }}</strong>, <em>Past Chair</em></p>
-        <p align="center" type="officeholder"><strong>{{ std_board["secretary"] }}</strong>, <em>Secretary</em></p>
-        {% for m in std_board["members"] %}
-        <p type="officemember">{{ m }}</p>
-        {% endfor %}
+        <membership>
+          <ul>
+            <li><dl><dt>name</dt><dd>&#x3c;Chair Name&#x3e;</dd><dt>role</dt><dd>Chair</dd></dl></li>
+            <li><dl><dt>name</dt><dd>&#x3c;Vice-chair Name&#x3e;</dd><dt>role</dt><dd>Vice Chair</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Participant1</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Participant2</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Participant3</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Participant4</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Participant5</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Participant6</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Participant7</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Participant8</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Participant9</dd><dt>role</dt><dd>Member</dd></dl></li>
+          </ul>
+        </membership>
+      </clause>
+      <clause id="boilerplate-participants-bg">
+        <p>The following members of the {{ balloting_group_type }} {{ balloting_group }} Standards Association balloting group voted on this {{ doctype }}. Balloters may have voted for approval, disapproval, or abstention.</p>
+        <membership>
+        <ul>
+            <li><dl><dt>name</dt><dd>Balloter1</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Balloter2</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Balloter3</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Balloter4</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Balloter5</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Balloter6</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Balloter7</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Balloter8</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>Balloter9</dd><dt>role</dt><dd>Member</dd></dl></li>
+        </ul>
+      </membership>
+      </clause>
+      <clause id="boilerplate-participants-sb">
+        <p>When the IEEE SA Standards Board approved this {{ doctype }} on {{ issueddate }}, it had the following membership:</p>
+        <membership>
+          <ul>
+            <li><dl><dt>name</dt><dd>&#x3c;Name&#x3e;</dd><dt>role</dt><dd>Chair</dd></dl></li>
+            <li><dl><dt>name</dt><dd>&#x3c;Name&#x3e;</dd><dt>role</dt><dd>Vice Chair</dd></dl></li>
+            <li><dl><dt>name</dt><dd>&#x3c;Name&#x3e;</dd><dt>role</dt><dd>Past Chair</dd></dl></li>
+            <li><dl><dt>name</dt><dd>&#x3c;Name&#x3e;</dd><dt>role</dt><dd>Secretary</dd></dl></li>
+            <li><dl><dt>name</dt><dd>SBMember1</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>SBMember2</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>SBMember3</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>SBMember4</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>SBMember5</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>SBMember6</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>SBMember7</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>SBMember8</dd><dt>role</dt><dd>Member</dd></dl></li>
+            <li><dl><dt>name</dt><dd>SBMember9</dd><dt>role</dt><dd>Member</dd></dl></li>
+        </ul>
+        </membership>
         <p type="emeritus_sign">*Member Emeritus</p>
+      </clause>
     </clause>
   </legal-statement>
   <feedback-statement>
@@ -272,7 +307,7 @@
 
     <clause>
       <p>Copyright © {{ docyear }} by The Institute of Electrical and Electronics Engineers, Inc.</p>
-      <p>All rights reserved. Published {{ issued_date }}. Printed in the United States of America.</p>
+      <p>All rights reserved. Published {{ issueddate }}. Printed in the United States of America.</p>
     </clause>
 
     <clause>
@@ -294,5 +329,19 @@
         <em>No part of this publication may be reproduced in any form, in an electronic retrieval system or otherwise, without the prior written permission of the publisher.</em></p>
     </clause>
   </feedback-statement>
+  {% if docsubtype == "Amendment" or docsubtype == "Corrigendum" %}
+  <note id="boilerplate_front">
+    <p>The editing instructions contained in this {{ docsubtype | downcase }} define how to merge the material contained therein into the existing base standard and its amendments to form the comprehensive standard.</p>
+    <p>The editing instructions are shown in <strong><em>bold italic</em></strong>. Four editing instructions are used: change, delete, insert, and replace. <strong><em>Change</em></strong> is used to make corrections in existing text or tables. The editing instruction specifies the location of the change and describes what is being changed by using <strike>strikethrough</strike> (to remove old material) and <underline>underscore</underline> (to add new material). <strong><em>Delete</em></strong> removes existing material. <strong><em>Insert</em></strong> adds new material without disturbing the existing material. Insertions may require renumbering. If so, renumbering instructions are given in the editing instruction. <strong><em>Replace</em></strong> is used to make changes in figures or equations by removing the existing figure or equation and replacing it with a new one. Editing instructions, change markings, and this NOTE will not be carried over into future editions because the changes will be incorporated into the base standard.</p>
+  </note>
+  {% else %}
+  <clause id="boilerplate_word_usage">
+    <title>Word usage</title>
+    <p>The word <em>shall</em> indicates mandatory requirements strictly to be followed in order to conform to the standard and from which no deviation is permitted (<em>shall</em> equals <em>is required to</em>).<fn><p>The use of the word <em>must</em> is deprecated and cannot be used when stating mandatory requirements; <em>must</em> is used only to describe unavoidable situations.</p></fn><fn><p>The use of <em>will</em> is deprecated and cannot be used when stating mandatory requirements; <em>will</em> is only used in statements of fact.</p></fn></p>
+    <p>The word <em>should</em> indicates that among several possibilities one is recommended as particularly suitable, without mentioning or excluding others; or that a certain course of action is preferred but not necessarily required (<em>should</em> equals <em>is recommended that</em>).</p>
+    <p>The word <em>may</em> is used to indicate a course of action permissible within the limits of the standard (<em>may</em> equals <em>is permitted to</em>).</p>
+    <p>The word <em>can</em> is used for statements of possibility and capability, whether material, physical, or causal (<em>can</em> equals <em>is able to</em>).</p>
+  </clause>
+  {% endif %}
 </boilerplate>
 

data/lib/metanorma/ieee/cleanup.rb

@@ -1,4 +1,5 @@
 require_relative "cleanup_ref"
+require_relative "term_lookup_cleanup"
 
 module Metanorma
   module IEEE
@@ -6,6 +7,9 @@ module Metanorma
       def initial_boilerplate(xml, isodoc)
         intro_boilerplate(xml, isodoc)
         super
+        initial_note(xml)
+        word_usage(xml)
+        participants(xml)
       end
 
       def intro_boilerplate(xml, isodoc)
@@ -18,6 +22,22 @@ module Metanorma
         intro.next = "<admonition>#{adm}</admonition>"
       end
 
+      def initial_note(xml)
+        n = xml.at("//boilerplate//note[@id = 'boilerplate_front']")
+        s = xml.at("//sections")
+        (n && s) or return
+        s.children.empty? and s << " "
+        s.children.first.previous = n.remove
+      end
+
+      def word_usage(xml)
+        n = xml.at("//boilerplate//clause[@id = 'boilerplate_word_usage']")
+          &.remove
+        s = xml.at("//clause[@type = 'overview']")
+        (n && s) or return
+        s << n
+      end
+
       def obligations_cleanup_norm(xml)
         super
         xml.xpath("//sections/clause").each do |r|
@@ -53,39 +73,6 @@ module Metanorma
         ins << "<fn><p>#{@i18n.note_inform_fn}</p></fn>"
       end
 
-      def termdef_cleanup(xmldoc)
-        term_reorder(xmldoc)
-        super
-      end
-
-      def term_reorder(xmldoc)
-        xmldoc.xpath("//terms").each do |t|
-          term_reorder1(t)
-        end
-      end
-
-      def term_reorder1(terms)
-        ins = terms.at("./term")&.previous_element or return
-        coll = terms.xpath("./term")
-        ret = sort_terms(coll)
-        coll.each(&:remove)
-        ret.reverse.each { |t| ins.next = t }
-      end
-
-      def sort_terms(terms)
-        terms.sort do |a, b|
-          sort_terms_key(a) <=> sort_terms_key(b)
-        end
-      end
-
-      def sort_terms_key(term)
-        d = term.at("./preferred/expression/name | "\
-                    "./preferred/letter-designation/name | "\
-                    "./preferred/graphical-symbol/figure/name | "\
-                    "./preferred/graphical-symbol/figure/@id")
-        d.text.downcase
-      end
-
       def table_footnote_renumber1(fnote, idx, seen)
         content = footnote_content(fnote)
         idx += 1
@@ -119,6 +106,82 @@ module Metanorma
       end
 
       def term_defs_boilerplate_cont(src, term, isodoc); end
+
+      def termlookup_cleanup(xmldoc)
+        Metanorma::IEEE::TermLookupCleanup.new(xmldoc, @log).call
+      end
+
+      def boilerplate_isodoc(xmldoc)
+        x = xmldoc.dup
+        x.root.add_namespace(nil, self.class::XML_NAMESPACE)
+        xml = Nokogiri::XML(x.to_xml)
+        i = isodoc(@lang, @script)
+        i.bibdata_i18n(xml.at("//xmlns:bibdata"))
+        i.info(xml, nil)
+        i
+      end
+
+      def participants(xml)
+        populate_participants(xml, "boilerplate-participants-wg",
+                              "working group")
+        populate_participants(xml, "boilerplate-participants-bg",
+                              "balloting group")
+        populate_participants(xml, "boilerplate-participants-sb",
+                              "standards board")
+        p = xml.at(".//p[@type = 'emeritus_sign']")
+        ul = xml.at("//clause[@id = 'boilerplate-participants-sb']//ul")
+        p && ul and ul.next = p
+        xml.at("//clause[@type = 'participants']")&.remove
+      end
+
+      def populate_participants(xml, target, subtitle)
+        t = xml.at("//clause[@id = '#{target}']/membership")
+        s = xml.xpath("//clause[@type = 'participants']/clause").detect do |x|
+          n = x.at("./title") and n.text.strip.downcase == subtitle
+        end
+        t.replace(populate_participants1(s || t))
+      end
+
+      def populate_participants1(clause)
+        participants_dl_to_ul(clause)
+        clause.xpath(".//ul | .//ol").each do |ul|
+          ul.name = "ul"
+          ul.xpath("./li").each { |li| populate_participants2(li) }
+          ul.xpath(".//p[normalize-space() = '']").each(&:remove)
+        end
+        clause.children.to_xml
+      end
+
+      def participants_dl_to_ul(clause)
+        clause.xpath(".//dl[.//dl]").each do |dl|
+          dl.name = "ul"
+          dl.xpath("./dt").each(&:remove)
+          dl.xpath("./dd").each { |li| li.name = "li" }
+        end
+      end
+
+      def populate_participants2(list)
+        c = HTMLEntities.new
+        if dl = list.at("./dl")
+          ret = extract_participants(dl)
+          dl.children = ret.keys.map do |k|
+            "<dt>#{k}</dt><dd>#{c.encode(ret[k], :hexadecimal)}</dd>"
+          end.join
+        else
+          list.children = "<dl><dt>name</dt><dd>#{list.children.to_xml}</dd>"\
+                          "<dt>role</dt><dd>member</dd></dl>"
+        end
+      end
+
+      def extract_participants(dlist)
+        key = ""
+        map = dlist.xpath("./dt | ./dd").each_with_object({}) do |dtd, m|
+          (dtd.name == "dt" and key = dtd.text.sub(/:+$/, "")) or
+            m[key.strip.downcase] = dtd.text.strip
+        end
+        map["role"] ||= "member"
+        map
+      end
     end
   end
 end

data/lib/metanorma/ieee/cleanup_ref.rb

@@ -34,6 +34,7 @@ module Metanorma
         name = designator_or_name(bib)
         title = bib.at("./title[@type = 'main']")&.text ||
           bib.at("./title")&.text || bib.at("./formattedref")&.text
+        title.gsub!(/[[:punct:]]/, "")
         "#{name}. #{title}"
       end
 

data/lib/metanorma/ieee/converter.rb

@@ -34,10 +34,17 @@ module Metanorma
         when "Overview" then attrs[:type] = "overview"
         when "Scope" then attrs[:type] = "scope"
         when "Word Usage" then attrs[:type] = "word-usage"
+        when "Participants" then attrs[:type] = "participants"
         end
         super
       end
 
+      def termsource_attrs(node, matched)
+        ret = super
+        node.option? "adapted" and ret[:status] = "adapted"
+        ret
+      end
+
       def outputs(node, ret)
         File.open("#{@filename}.xml", "w:UTF-8") { |f| f.write(ret) }
         presentation_xml_converter(node).convert("#{@filename}.xml")

data/lib/metanorma/ieee/front.rb

@@ -4,6 +4,9 @@ module Metanorma
       def metadata_committee(node, xml)
         return unless node.attr("committee") || node.attr("society")
 
+        node.attr("balloting-group") && !node.attr("balloting-group-type") and
+          node.set_attr("balloting-group-type", "individual")
+
         xml.editorialgroup do |a|
           committee_component("society", node, a)
           committee_component("balloting-group", node, a)
@@ -29,59 +32,6 @@ module Metanorma
         xml.docnumber node.attr("docnumber")
       end
 
-      def metadata_author(node, xml)
-        super
-        wg_members(node, xml)
-        bg_members(node, xml)
-        std_board_members(node, xml)
-      end
-
-      def metadata_editor(name, role, xml)
-        xml.contributor do |c|
-          c.role role, **{ type: "editor" }
-          c.person do |p|
-            p.name do |n|
-              n.completename name
-            end
-          end
-        end
-      end
-
-      def metadata_multi_editors(names, role, xml)
-        csv_split(names).each do |n|
-          metadata_editor(n, role, xml)
-        end
-      end
-
-      def wg_members(node, xml)
-        a = node.attr("wg-chair") and
-          metadata_editor(a, "Working Group Chair", xml)
-        a = node.attr("wg-vicechair") and
-          metadata_editor(a, "Working Group Vice-Chair", xml)
-        a = node.attr("wg-secretary") and
-          metadata_editor(a, "Working Group Secretary", xml)
-        a = node.attr("wg-members") and
-          metadata_multi_editors(a, "Working Group Member", xml)
-      end
-
-      def bg_members(node, xml)
-        a = node.attr("balloting-group-members") and
-          metadata_multi_editors(a, "Balloting Group Member", xml)
-      end
-
-      def std_board_members(node, xml)
-        a = node.attr("std-board-chair") and
-          metadata_editor(a, "Standards Board Chair", xml)
-        a = node.attr("std-board-vicechair") and
-          metadata_editor(a, "Standards Board Vice-Chair", xml)
-        a = node.attr("std-board-pastchair") and
-          metadata_editor(a, "Standards Board Past Chair", xml)
-        a = node.attr("std-board-secretary") and
-          metadata_editor(a, "Standards Board Secretary", xml)
-        a = node.attr("balloting-group-members") and
-          metadata_multi_editors(a, "Standards Board Member", xml)
-      end
-
       def metadata_publisher(node, xml)
         publishers = node.attr("publisher") || "IEEE"
         csv_split(publishers).each do |p|
@@ -112,6 +62,23 @@ module Metanorma
         end
       end
 
+      def metadata_status(node, xml)
+        status = node.attr("status") || node.attr("docstage") ||
+          (node.attr("draft") ? "developing" : "active")
+        xml.status do |s|
+          s.stage status
+        end
+      end
+
+      def datetypes
+        super + %w{feedback-ended}
+      end
+
+      def metadata_subdoctype(node, xml)
+        xml.subdoctype (node.attr("docsubtype") || "document")
+        s = node.attr("trial-use") and xml.trial_use s
+      end
+
       def org_abbrev
         { "Institute of Electrical and Electronic Engineers" => "IEEE" }
       end
@@ -119,6 +86,26 @@ module Metanorma
       def relaton_relations
         super + %w(merges updates)
       end
+
+      def metadata_ext(node, xml)
+        super
+        structured_id(node, xml)
+      end
+
+      def structured_id(node, xml)
+        return unless node.attr("docnumber")
+
+        xml.structuredidentifier do |i|
+          i.docnumber node.attr("docnumber")
+          i.agency "IEEE"
+          i.class_ doctype(node)
+          a = node.attr("edition") and i.edition a
+          a = node.attr("draft") and i.version a
+          a = node.attr("amendment-number") and i.amendment a
+          a = node.attr("corrigendum-number") and i.corrigendum a
+          a = node.attr("copyright-year") and i.year a
+        end
+      end
     end
   end
 end

data/lib/metanorma/ieee/ieee.rng

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<grammar ns="https://www.metanorma.org/ns/ieee" xmlns="http://relaxng.org/ns/structure/1.0">
+<grammar ns="https://www.metanorma.org/ns/ieee" xmlns="http://relaxng.org/ns/structure/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes">
   <!--
     Currently we inherit from a namespaced grammar, isostandard. Until we inherit from isodoc,
     we cannot have a new default namespace: we will end up with a grammar with two different
@@ -16,6 +16,15 @@
         <value>standard</value>
       </choice>
     </define>
+    <define name="stage">
+      <element name="stage">
+        <choice>
+          <value>developing</value>
+          <value>active</value>
+          <value>inactive</value>
+        </choice>
+      </element>
+    </define>
     <define name="editorialgroup">
       <element name="editorialgroup">
         <ref name="society"/>
@@ -27,7 +36,11 @@
       </element>
     </define>
     <define name="DocumentSubtype">
-      <value>trial-use</value>
+      <choice>
+        <value>amendment</value>
+        <value>corrigendum</value>
+        <value>erratum</value>
+      </choice>
     </define>
     <define name="BibDataExtensionType">
       <optional>
@@ -36,14 +49,31 @@
       <optional>
         <ref name="docsubtype"/>
       </optional>
+      <optional>
+        <ref name="trialuse"/>
+      </optional>
       <ref name="editorialgroup"/>
       <zeroOrMore>
         <ref name="ics"/>
       </zeroOrMore>
     </define>
   </include>
+  <define name="BibliographicDateType" combine="choice">
+    <value>feecback-ended</value>
+  </define>
+  <define name="trialuse">
+    <element name="trial-use">
+      <data type="boolean"/>
+    </element>
+  </define>
   <define name="balloting-group">
     <element name="balloting-group">
+      <attribute name="type">
+        <choice>
+          <value>individual</value>
+          <value>entity</value>
+        </choice>
+      </attribute>
       <text/>
     </element>
   </define>

data/lib/metanorma/ieee/isodoc.rng

@@ -2504,6 +2504,16 @@
           <text/>
         </element>
       </optional>
+      <optional>
+        <element name="amendment">
+          <text/>
+        </element>
+      </optional>
+      <optional>
+        <element name="corrigendum">
+          <text/>
+        </element>
+      </optional>
       <optional>
         <element name="language">
           <text/>

data/lib/metanorma/ieee/term_lookup_cleanup.rb

@@ -0,0 +1,11 @@
+module Metanorma
+  module IEEE
+    class TermLookupCleanup < Metanorma::Standoc::TermLookupCleanup
+      def remove_missing_ref_term(node, _target)
+        node.at("../xrefrender")&.remove
+        node.replace("<preferred><expression><name>#{node.children.to_xml}"\
+                     "</name></expression></preferred>")
+      end
+    end
+  end
+end

data/lib/metanorma/ieee/validate.rb

@@ -19,71 +19,30 @@ module Metanorma
         list_validate(doc)
         table_style(doc)
         figure_validate(doc)
+        amend_validate(doc)
       end
 
       def bibdata_validate(doc)
         doctype_validate(doc)
-        # stage_validate(doc)
-        # substage_validate(doc)
+        stage_validate(doc)
       end
 
       def doctype_validate(xmldoc)
         doctype = xmldoc&.at("//bibdata/ext/doctype")&.text
-        %w(standard recommended-practice guide
-           amendment technical-corrigendum).include? doctype or
+        %w(standard recommended-practice guide).include? doctype or
           @log.add("Document Attributes", nil,
                    "#{doctype} is not a recognised document type")
+        docsubtype = xmldoc&.at("//bibdata/ext/subdoctype")&.text or return
+        %w(amendment corrigendum erratum document).include? docsubtype or
+          @log.add("Document Attributes", nil,
+                   "#{docsubtype} is not a recognised document subtype")
       end
 
-      def title_validate(xml)
-        title_validate_type(xml)
-        title_validate_capitalisation(xml)
-      end
-
-      # Style Manual 11.3
-      def title_validate_type(xml)
-        title = xml.at("//bibdata/title") or return
-        draft = xml.at("//bibdata//draft")
-        type = xml.at("//bibdata/ext/doctype")
-        subtype = xml.at("//bibdata/ext/subdoctype")
-        target = draft ? "Draft " : ""
-        target += subtype ? "#{strict_capitalize_phrase(subtype.text)} " : ""
-        target += type ? "#{strict_capitalize_phrase(type.text)} " : ""
-        /^#{target}/.match?(title.text) or
-          @log.add("Style", title,
-                   "Expected title to start as: #{target}")
-      end
-
-      def strict_capitalize_phrase(str)
-        ret = str.split(/[ -]/).map do |w|
-          letters = w.chars
-          letters.first.upcase! unless /^[ -]/.match?(w)
-          letters.join
-        end.join(" ")
-        ret = "Trial-Use" if ret == "Trial Use"
-        ret
-      end
-
-      # Style Manual 11.3
-      def title_validate_capitalisation(xml)
-        title = xml.at("//bibdata/title") or return
-        found = false
-        title.text.split(/[ -]/).each do |w|
-          /^[[:upper:]]/.match?(w) or preposition?(w) or
-            found = true
-        end
-        found and @log.add("Style", title,
-                           "Title contains uncapitalised word other than preposition")
-      end
-
-      def preposition?(word)
-        %w(aboard about above across after against along amid among anti around
-           as at before behind below beneath beside besides between beyond but
-           by concerning considering despite down during except excepting
-           excluding following for from in inside into like minus near of off
-           on onto opposite outside over past per plus regarding round save
-           since than through to toward towards under underneath unlike until
-           up upon versus via with within without a an the).include?(word)
+      def stage_validate(xmldoc)
+        stage = xmldoc&.at("//bibdata/status/stage")&.text
+        %w(active inactive developing).include? stage or
+          @log.add("Document Attributes", nil,
+                   "#{stage} is not a recognised stage")
       end
 
       def locality_validate(root)
@@ -237,6 +196,51 @@ module Metanorma
                      "More than one image in the table cell")
         end
       end
+
+      # Style manual 20.2.2
+      def amend_validate(xmldoc)
+        xmldoc.xpath("//amend").each do |a|
+          desc = a.at("./description")
+          if desc && !desc.text.strip.empty?
+            amend_validate1(a, desc.text.strip,
+                            a.at("./newcontent//figure | "\
+                                 "./newcontent//formula"))
+          else @log.add("Style", a,
+                        "Editorial instruction is missing from change")
+          end
+        end
+      end
+
+      def amend_validate1(amend, description, figure_or_formula)
+        case amend["change"]
+        when "add" then /^Insert /.match?(description) or
+          @log.add("Style", amend,
+                   "'Add' change description should start with _Insert_")
+        when "delete" then /^Insert /.match?(description) or
+          @log.add("Style", amend,
+                   "'Delete' change description should start with _Delete_")
+        when "modify"
+          amend_validate_modify(amend, description, figure_or_formula)
+        end
+      end
+
+      AMD_VALID_MOD = [
+        "'Modify' change description should start with _Change_ or _Replace_",
+        "'Modify' change description for change involving figure or equation "\
+        "should start with _Replace_",
+        "'Modify' change description for change not involving figure or "\
+        "equation should start with _Change_",
+      ].freeze
+
+      def amend_validate_modify(amend, description, figure_or_formula)
+        if !/^Change |^Replace/.match?(description)
+          @log.add("Style", amend, AMD_VALID_MOD[0])
+        elsif /^Change /.match?(description)
+          !figure_or_formula or @log.add("Style", amend, AMD_VALID_MOD[1])
+        else
+          figure_or_formula or @log.add("Style", amend, AMD_VALID_MOD[2])
+        end
+      end
     end
   end
 end