MN -> PDF: Duplicate sub-clauses in bibliography section, BSI PDF

[manuelfuenmayor]

In relation to https://github.com/metanorma/metanorma-bsi/issues/30

In bibliography section, Standard publications and Other publications are duplicated.

From bs-7000-4:

Also notice that the text:

For dated references, only the edition cited applies. For undated references,
the latest edition of the referenced document (including any amendments) applies.

is duplicated. But that seems to be a markup issue from mnconvert.

[Intelligent2013]

Looks like regarding https://www.metanorma.org/author/topics/document-format/bibliography/#general I have to remove the first attribute [bibliography].

[Intelligent2013]

No, the reason of issue in something another...

Adoc:

== Bibliography

[bibliography]
=== Standards publications

* [[[BS_7000-2,BS 7000-2]]], _Design management systems — Part 2: Guide to managing the design of manufactured products_

* [[[BS_7000-3,BS 7000-3]]], _Design management systems — Part 3: Guide to managing service design_

* [[[BS_8534,BS 8534]]], _Construction procurement policies, strategies and procedures — Code of practice_

* [[[BS_EN_ISO_9001,BS EN ISO 9001]]], _Quality management systems — Requirements_

* [[[BS_ISO_15489-1,BS ISO 15489-1]]], _Information and documentation — Records management — Part 1: General_

* [[[BS_ISO_16739,BS ISO 16739]]], _Industry Foundation Classes (IFC) for data sharing in the construction and facility management industries_

* [[[BS_ISO/IEC_27000,BS ISO/IEC 27000]]], _Information technology — Security technique — Information security management systems — Overview and vocabulary_

* [[[PAS_55,PAS 55]]], _Specification for the optimized management of physical assets_

* [[[PAS_91,PAS 91]]], _Construction prequalification questionnaires_

[bibliography]
=== Other publications

* [[[biblref_1,1]]] RICHARDS, M. BIP 2207. __Building information management – A standard framework and guide to BS 1192.__ London: BSI, 2010.

* [[[biblref_2,2]]] CONSTRUCTION INDUSTRY COUNCIL. __Building information model (BIM) protocol. First Edition.__ London: CIC, 2013.

* [[[biblref_3,3]]] BIM TASK GROUP. __Outline Scope of Services for the Role of Information Management. First Edition.__ London: CIC, 2013.

* [[[biblref_4,4]]] CONSTRUCTION INDUSTRY COUNCIL. __Scope of services. First Edition.__ London: CIC, 2007.

* [[[biblref_5,5]]] ROYAL INSTITUTE OF BRITISH ARCHITECTS. _Plan of work_. RIBA, 2013. footnote:[Available at http://www.ribaplanofwork.com/Download.aspx[http://www.ribaplanofwork.com/Download.aspx]])

* [[[biblref_6,6]]] NETWORK RAIL. __The guide to railway investment projects.__ Network rail, 2012.

* [[[biblref_7,7]]] OFFICE OF GOVERNMENT COMMERCE. __The OGC Gateway™ Process: A manager’s checklist.__ OGC, 2013.

* [[[biblref_8,8]]] ROYAL INSTITUTE OF BRITISH ARCHITECTS. _Plan of work_. London: RIBA, 2007.

* [[[biblref_9,9]]] HAWKINS, G. Building Services Job Book - _A project framework for engineering services_ (BG 1/2009). BSRIA, 2009.

* [[[biblref_10,10]]] CONSTRUCTION PROJECT INFORMATION COMMITTEE. _The CPIx protocol_  footnote:[Available from http://www.cpic.org.uk/[http://www.cpic.org.uk/], in preparation])CPIc, 2013.

* [[[biblref_11,11]]] HOWES, P. and SHIPMAN, A. BIP 0008-2. __Evidential weight and legal admissibility of information transferred electronically – Code of practice for the implementation of BS 10008.__ London: BSI, 2008.

* [[[biblref_12,12]]] BIM TASK GROUP. __COBie UK 2012.__ London: Construction Industry Council, 2012.

* [[[biblref_13,13]]] BIM TASK GROUP. __Employers Information Requirements (EIR__). First Edition. London: Construction Industry Council, 2013.

<bibliography>
    <clause id="_bibliography" obligation="informative" displayorder="5">
        <title depth="1">Bibliography</title>
        <references id="_standards_publications" normative="false" obligation="informative">
            <title depth="2">Standards publications</title>
            <references id="_" normative="false" unnumbered="true">
                <title depth="3">Standards publications</title>
                <p id="_">For dated references, only the edition cited applies.....</p>
                <bibitem id="BS_8534" type="standard"> ...
                <bibitem id="BS_EN_ISO_9001" type="standard">...
                <bibitem id="BS_ISO_15489-1" type="standard"> ...
                <bibitem id="BS_7000-2" type="standard">...
                <bibitem id="BS_7000-3" type="standard">...
                <bibitem id="BS_ISO_16739">...
            </references>
            <references id="_" normative="false" unnumbered="true">
                <title depth="3">Other publications</title>
                <bibitem id="PAS_55">
                    <formattedref format="application/x-isodoc+xml">
                        <em>Specification for the optimized management of physical assets</em>
                    </formattedref>
                    <docidentifier type="metanorma">[1]</docidentifier>
                    <docidentifier>PAS 55</docidentifier>
                    <docnumber>55</docnumber>
                </bibitem>
                <bibitem id="PAS_91">
                    <formattedref format="application/x-isodoc+xml">
                        <em>Construction prequalification questionnaires</em>
                    </formattedref>
                    <docidentifier type="metanorma">[2]</docidentifier>
                    <docidentifier>PAS 91</docidentifier>
                    <docnumber>91</docnumber>
                </bibitem>
            </references>
        </references>
        <references id="_other_publications" normative="false" obligation="informative">
            <title depth="2">Other publications</title>
            <bibitem id="biblref_2">
                <formattedref format="application/x-isodoc+xml">CONSTRUCTION INDUSTRY COUNCIL. <em>Building information model (BIM) protocol. First Edition.</em> London: CIC, 2013.</formattedref>
                <docidentifier type="metanorma">[3]</docidentifier>
            </bibitem>
            <bibitem id="biblref_3">
                <formattedref format="application/x-isodoc+xml">BIM TASK GROUP. <em>Outline Scope of Services for the Role of Information Management. First Edition.</em> London: CIC, 2013.</formattedref>
                <docidentifier type="metanorma">[4]</docidentifier>
            </bibitem>
            ...
        </references>
    </clause>
</bibliography>

@opoudjis could you clarify, what is the mistake in adoc markup that raises two issues?

1. duplicated Standards publications (<title depth="2">Standards publications</title> and <title depth="3">Standards publications</title>)
2. duplicated Other publications with two last bibliographic references from Standards publications in the first, and rest in the second.

[opoudjis]

The real solution here is to bite the bullet, and not automatically infer subheadings for references, but allow users to just specify them, as we have done elsewhere in Metanorma: https://github.com/metanorma/metanorma-bsi/issues/53.

What is happening here is simply that I am assuming that there are no subheadings for "Standards publications" and "Other publications" in BSI publications, and force inserting them. Because you already have them there, @Intelligent2013, they are occurring twice. But don't change what you're doing, I'm going to drop my existing approach of intervention.

@manuel489 @anermina this is a change to markup, but it's an inevitable one. I'm prioritising https://github.com/metanorma/metanorma-bsi/issues/53 for implementation now, and treating this issue as a duplicate thereof.