Skip to content

Specify DOI for SMPTE refs #314

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 10 commits into
base: main
Choose a base branch
from
Open

Specify DOI for SMPTE refs #314

Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
943e8db
Specify AG-29 for SMPTE refs
SteveLLamb Mar 4, 2025
b1e8c69
split into two statements
SteveLLamb Mar 4, 2025
1c915cc
add should to ISO statement
SteveLLamb Mar 4, 2025
8437d9c
update undated ref text
SteveLLamb Mar 5, 2025
e02937c
update wording to AG-29
SteveLLamb Mar 5, 2025
6a75a5b
Merge branch 'main' into issues/0313-smpte-refs
SteveLLamb Apr 15, 2025
b07683a
change to DOI for referencing
SteveLLamb Apr 15, 2025
24d6c25
add SMPTE DOI examples
SteveLLamb Apr 15, 2025
64b8826
fix ref link
SteveLLamb Apr 15, 2025
de9161d
Merge branch 'main' into issues/0313-smpte-refs
SteveLLamb Apr 25, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 18 additions & 1 deletion doc/main.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -567,14 +567,29 @@ <h4>Normative references section</h4>
<li>Each <code>li</code> element may contain one <code>a</code> element that contains a location where the reference can
be retrieved.</li>
</ul>

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

<p>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. </p>

<p class="note">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.</p>

<div class="example">
<pre>&lt;section id=&quot;sec-normative-references&quot;&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;cite id=&quot;bib-HTML-5&quot;&gt;HTML Standard&lt;/cite&gt;, Living Standard.
&lt;a&gt;https://html.spec.whatwg.org/multipage/&lt;/a&gt;&lt;/li&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;cite id=&quot;bib-SMPTE-st429-18&quot;&gt;SMPTE ST 429-18&lt;/cite&gt;, D-Cinema Packaging — Immersive Audio Track
File
&lt;a&gt;https://doi.org/10.5594/SMPTE.ST429-18/&lt;/a&gt;&lt;/li&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;cite id=&quot;bib-SMPTE-st429-18-2023&quot;&gt;SMPTE ST 429-18:2023&lt;/cite&gt;, D-Cinema Packaging — Immersive
Audio Track File (2023 Edition)
&lt;a&gt;https://doi.org/10.5594/SMPTE.ST429-18.2023/&lt;/a&gt;&lt;/li&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/section&gt;</pre>
</div>
Expand Down Expand Up @@ -2375,6 +2390,8 @@ <h3>Sample Workflow </h3>
<a>https://doc.smpte-doc.org/ag-02/main/</a></li>
<li><cite id="bib-smpte-ag-16">SMPTE AG 16</cite>, Standards Style Guide.
<a>https://doc.smpte-doc.org/ag-16/main/</a></li>
<li><cite id="bib-ag-29">SMPTE AG-29</cite>, Document Library: URL Spec (Persistent URIs)
<a>https://github.com/SMPTE/document-url-spec</a></li>
<li><cite id="bib-smpte-gh-om">SMPTE GitHub Operating Manual</cite>
<a>https://github.com/SMPTE/github-operating-manual</a></li>
</ul>
Expand Down