From 943e8db969c1a2da036437881281ce4f61707c76 Mon Sep 17 00:00:00 2001 From: Steve LLamb <38917682+SteveLLamb@users.noreply.github.com> Date: Tue, 4 Mar 2025 10:55:19 -0800 Subject: [PATCH 1/8] Specify AG-29 for SMPTE refs --- doc/main.html | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/doc/main.html b/doc/main.html index 80d5435..46e5793 100644 --- a/doc/main.html +++ b/doc/main.html @@ -527,7 +527,8 @@

Normative references section

  • Each li element may contain one a element that contains a location where the reference can be retrieved.
  • - +

    It is recommended to use undated references (to designate using the latest version), except for when needed as per . For SMPTE documents, see for the specification of persistent link URIs for both "latest" and specific versions of a document referenced.

    +
    <section id="sec-normative-references">
       <ul>
    @@ -2335,6 +2336,8 @@ 

    Sample Workflow

    https://doc.smpte-doc.org/ag-02/main/
  • SMPTE AG 16, Standards Style Guide. https://doc.smpte-doc.org/ag-16/main/
  • +
  • SMPTE AG-29, Document Library: URL Spec (Persistent URIs) + https://github.com/SMPTE/document-url-spec
  • SMPTE GitHub Operating Manual https://github.com/SMPTE/github-operating-manual
  • From b1e8c6914fa11704cc8063a48c553cb9c0695aab Mon Sep 17 00:00:00 2001 From: Steve LLamb <38917682+SteveLLamb@users.noreply.github.com> Date: Tue, 4 Mar 2025 12:04:56 -0800 Subject: [PATCH 2/8] split into two statements --- doc/main.html | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/main.html b/doc/main.html index 46e5793..4a4ce0c 100644 --- a/doc/main.html +++ b/doc/main.html @@ -527,7 +527,9 @@

    Normative references section

  • Each li element may contain one a element that contains a location where the reference can be retrieved.
  • -

    It is recommended to use undated references (to designate using the latest version), except for when needed as per . For SMPTE documents, see for the specification of persistent link URIs for both "latest" and specific versions of a document referenced.

    +

    It is recommended to use undated references (to designate using the latest version), except for when needed as per . + +

    For SMPTE documents, see for the specification of persistent link URIs for both "latest" and specific versions of a document referenced.

    <section id="sec-normative-references">
    
    From 1c915cc2e922f5fd5f105d680a8b4075fbcd996a Mon Sep 17 00:00:00 2001
    From: Steve LLamb <38917682+SteveLLamb@users.noreply.github.com>
    Date: Tue, 4 Mar 2025 12:05:20 -0800
    Subject: [PATCH 3/8] add should to ISO statement
    
    ---
     doc/main.html | 2 +-
     1 file changed, 1 insertion(+), 1 deletion(-)
    
    diff --git a/doc/main.html b/doc/main.html
    index 4a4ce0c..8141407 100644
    --- a/doc/main.html
    +++ b/doc/main.html
    @@ -527,7 +527,7 @@ 

    Normative references section

  • Each li element may contain one a element that contains a location where the reference can be retrieved.
  • -

    It is recommended to use undated references (to designate using the latest version), except for when needed as per . +

    Undated references should always be used (to designate using the latest version), except for when needed, as per .

    For SMPTE documents, see for the specification of persistent link URIs for both "latest" and specific versions of a document referenced.

    From 8437d9c05dda9b971f027ffff0fb661250bbde89 Mon Sep 17 00:00:00 2001 From: Steve LLamb <38917682+SteveLLamb@users.noreply.github.com> Date: Wed, 5 Mar 2025 09:10:48 -0800 Subject: [PATCH 4/8] update undated ref text Co-authored-by: Pierre-Anthony Lemieux --- doc/main.html | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/main.html b/doc/main.html index 8141407..2e82297 100644 --- a/doc/main.html +++ b/doc/main.html @@ -527,7 +527,9 @@

    Normative references section

  • Each li element may contain one a element that contains a location where the reference can be retrieved.
  • -

    Undated references should always be used (to designate using the latest version), except for when needed, as per . +

    Undated references should be used, since they point to the most most up-to-date edition of a document.

    + +

    Dated references may be used when referencing a specific element of the document is necessary, e.g., a table, or when past and future editions of the document are likely to be inadequate.

    For SMPTE documents, see for the specification of persistent link URIs for both "latest" and specific versions of a document referenced.

    From e02937c16c6fabe49d78633510fa26a0ac51745a Mon Sep 17 00:00:00 2001 From: Steve LLamb <38917682+SteveLLamb@users.noreply.github.com> Date: Wed, 5 Mar 2025 09:11:29 -0800 Subject: [PATCH 5/8] update wording to AG-29 Co-authored-by: Pierre-Anthony Lemieux --- doc/main.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/main.html b/doc/main.html index 2e82297..a7bd60b 100644 --- a/doc/main.html +++ b/doc/main.html @@ -531,7 +531,7 @@

    Normative references section

    Dated references may be used when referencing a specific element of the document is necessary, e.g., a table, or when past and future editions of the document are likely to be inadequate.

    -

    For SMPTE documents, see for the specification of persistent link URIs for both "latest" and specific versions of a document referenced.

    +

    specifies the persistent URIs for both the most recent and specific editions of a SMPTE document.

    <section id="sec-normative-references">
    
    From b07683a1a9a787ab10634b49fa917a62dc8693f4 Mon Sep 17 00:00:00 2001
    From: Steve LLamb <38917682+SteveLLamb@users.noreply.github.com>
    Date: Tue, 15 Apr 2025 10:14:20 -0700
    Subject: [PATCH 6/8] change to DOI for referencing
    
    ---
     doc/main.html | 2 +-
     1 file changed, 1 insertion(+), 1 deletion(-)
    
    diff --git a/doc/main.html b/doc/main.html
    index a7bd60b..799a9ef 100644
    --- a/doc/main.html
    +++ b/doc/main.html
    @@ -531,7 +531,7 @@ 

    Normative references section

    Dated references may be used when referencing a specific element of the document is necessary, e.g., a table, or when past and future editions of the document are likely to be inadequate.

    -

    specifies the persistent URIs for both the most recent and specific editions of a SMPTE document.

    +

    DOI links should be used for both the most recent and specific editions of a SMPTE document. SMPTE HO can provide guidance for specific DOIs available.

    <section id="sec-normative-references">
    
    From 24d6c25bd4e9a7494f425106e12e8a50a642fc32 Mon Sep 17 00:00:00 2001
    From: Steve LLamb <38917682+SteveLLamb@users.noreply.github.com>
    Date: Tue, 15 Apr 2025 11:50:10 -0700
    Subject: [PATCH 7/8] add SMPTE DOI examples
    
    ---
     doc/main.html | 10 ++++++++++
     1 file changed, 10 insertions(+)
    
    diff --git a/doc/main.html b/doc/main.html
    index 799a9ef..de408b2 100644
    --- a/doc/main.html
    +++ b/doc/main.html
    @@ -540,6 +540,16 @@ 

    Normative references section

    <cite id="bib-HTML-5">HTML Standard</cite>, Living Standard. <a>https://html.spec.whatwg.org/multipage/</a></li> </li> + <li> + <cite id="bib-SMPTE-st429-18">SMPTE ST 429-18</cite>, D-Cinema Packaging — Immersive Audio Track + File + <a>https://doi.org/10.5594/SMPTE.ST429-18/</a></li> + </li> + <li> + <cite id="bib-SMPTE-st429-18:2023">SMPTE ST 429-18:2023</cite>, D-Cinema Packaging — Immersive + Audio Track File (2023 Edition) + <a>https://doi.org/10.5594/SMPTE.ST429-18.2023/</a></li> + </li> </ul> </section>
    From 64b88262074f6b4cbd62aec6b6321b4995cd7e6b Mon Sep 17 00:00:00 2001 From: Steve LLamb <38917682+SteveLLamb@users.noreply.github.com> Date: Tue, 15 Apr 2025 11:52:38 -0700 Subject: [PATCH 8/8] fix ref link --- doc/main.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/main.html b/doc/main.html index de408b2..e56d19f 100644 --- a/doc/main.html +++ b/doc/main.html @@ -546,7 +546,7 @@

    Normative references section

    <a>https://doi.org/10.5594/SMPTE.ST429-18/</a></li> </li> <li> - <cite id="bib-SMPTE-st429-18:2023">SMPTE ST 429-18:2023</cite>, D-Cinema Packaging — Immersive + <cite id="bib-SMPTE-st429-18-2023">SMPTE ST 429-18:2023</cite>, D-Cinema Packaging — Immersive Audio Track File (2023 Edition) <a>https://doi.org/10.5594/SMPTE.ST429-18.2023/</a></li> </li>