<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang xml:lang>
<head>
<meta charset="utf-8" />
<meta name="generator" content="pandoc" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
<meta name="author" content="Nat Sakimura (NAT.Consulting)" />
<meta name="author" content="Edmund Jay (Illumila)" />
<meta name="dcterms.date" content="2023-06-22" />
<meta name="description" content="This document provides provisions for drafting OIDF specs." />
<title>OIDF Directives, Part 1: Principles and rules for the structure and drafting of OIDF documents</title>
<style>
</style>
<style type="text/css">html {
color: #555;
margin: auto;
padding: 10px;
max-width: 76em;
}
@font-face {
font-family: 'Noto Sans';
font-style: normal;
font-weight: 400;
src: url(data:font/ttf;base64,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A0AAMQFlACAB/QAoAjwAMgFCACgDQAAxAfT//QGsADcCPAAyAV4AGAFeABEBGQAoAm8AVQKPADcBDABIAOEADgFeACUBeAAgAf0AJwLpACIDAwAWAw0ADwGyABgCfwAAAn8AAAJ/AAACfwAAAn8AAAJ/AAADcf//AngAPQIsAGECLABhAiwAYQIsAGEBUwAoAVMAKAFTAAEBUwAeAtoAHgL4AGEDDQA9Aw0APQMNAD0DDQA9Aw0APQI8AEADDQA9AtsAWgLbAFoC2wBaAtsAWgI2AAACXQBhAncAVQIxAC4CMQAuAjEALgIxAC4CMQAuAjEALgNgAC4B4AA3AjQANwI0ADcCNAA3AjQANwEC//8BAgBMAQL/2AEC//UCXQA3AmoAVQJdADcCXQA3Al0ANwJdADcCXQA3AjwAMgJdADcCagBPAmoATwJqAE8CagBPAf4AAQJnAFUB/gABAgwAYQEMAFUDoAA9A7IANgGiACgBeQAoALcAKAEsACgBvwAoAfQAKAPoACgArwAMAK8ADAD6AB8BZwAMAWcADAGgAB8BeABNAxcASADoACcBmAAnATYAKAE2ACcAgv9BAjwAFwMFABEBXgAKAV4AHgFeABwBXgAZAfQAAACmAAAAAAAAAAAAAAPoACkArwAMAK8ADAAA/osBXgATAV4AFAFeABECsAAPAloADwJaAA8DsgAPA7IADwECAFUBAv/JAkgANwG5ABkCKwAmAjwALQI8ABUCPAA/AjwANwH/AAgCTQA6AjwAMgFeABMBXgAlAV4AGAFeABEBXgAKAV4AHgFeABQBXgAcAV4AGQFeABEBXgATAV4AJQFeABgBXgARAV4ACgFeAB4BXgAUAV4AHAFeABkBXgARAAD/cwAA/hMAAP67AAD+FQAA/2wAAP/YAAD+oQAA/9gAAAAAAQQAAAEEAAABOABRAX8AkwH2AHMCjQAiAzwAOQFGAHMBYgBEAWIAOwJfAEkCJwAyAQwALgFUADEBDABIAa0AKgInADACJwBXAicALwInACgCJwALAicAQAInADcCJwAsAicANAInADQBJgBVASYALAInADICJwAyAicAMgIGAEcBZABsAa0AKgFkADYCJwAdAZv//gGHACwCHADqAXgANgInADIBBAAAAfQAKAPoACgBOABSATgAUQH0AFMB9ABRAyQASAInAEUAMgAyAAIAAAAAAAD/nAAyAAAAAAAAAAAAAAAAAAAAAAAAAAABTQAAAQIBAwADAAQABQAGAAcACAAJAAoACwAMAA0ADgAPABAAEQASABMAFAAVABYAFwAYABkAGgAbABwAHQAeAB8AIAAhACIAIwAkACUAJgAnACgAKQAqACsALAAtAC4ALwAwADEAMgAzADQANQA2ADcAOAA5ADoAOwA8AD0APgA/AEAAQQBCAEMARABFAEYARwBIAEkASgBLAEwATQBOAE8AUABRAFIAUwBUAFUAVgBXAFgAWQBaAFsAXABdAF4AXwBgAGEBBACjAIQAhQC9AJYA6ACGAI4AiwCdAKkApAEFAIoBBgCDAJMBBwEIAI0BCQCIAMMA3gEKAJ4AqgD1APQA9gCiAK0AyQDHAK4AYgBjAJAAZADLAGUAyADKAM8AzADNAM4A6QBmANMA0ADRAK8AZwDwAJEA1gDUANUAaADrAO0AiQBqAGkAawBtAGwAbgCgAG8AcQBwAHIAcwB1AHQAdgB3AOoAeAB6AHkAewB9AHwAuAChAH8AfgCAAIEA7ADuALoBCwEMALAAsQDYAQ0A3ADdANkAsgCzALYAtwDEALQAtQDFAIcAqwEOAQ8AvgC/ALwBEACMAREBEgETARQBFQEWARcBGAEZARoBGwEcAR0BHgEfASAAwADBASEBIgDXASMBJAElASYBJwEoASkBKgErASwBLQEuAS8BMAExATIBMwE0ATUBNgE3ATgBOQE6ATsBPAE9AT4BPwFAAUEBQgFDAUQBRQFGAUcBSAFJAUoBSwFMAU0BTgFPAVABUQFSAVMBVAFVAVYBVwFYAVkBWgFbAVwBXQFeAV8BYAFhAWIBYwFkAWUBZgFnAWgBaQFqAWsBbAFtAW4BbwFwAXEBcgFzAXQBdQF2AXcBeAF5AXoBewF8AX0BfgROVUxMAkNSB3VuaTAwQTAHdW5pMDBBRAlvdmVyc2NvcmUHdW5pMDBCMgd1bmkwMEIzB3VuaTAwQjUHdW5pMDBCOQRMZG90BGxkb3QJbWFjcm9ubW9kBm1pbnV0ZQZzZWNvbmQERXVybwd1bmkyMDc0B3VuaTIwNzUHdW5pMjA3Nwd1bmkyMDc4B3VuaTIwMDIHdW5pMjAwOQd1bmkyMDBCB3VuaUZFRkYHdW5pRkZGRAd1bmkwMkJDB3VuaTAyQkINaG9va2Fib3ZlY29tYgd1bmkyMDcwB3VuaTIwNzYHdW5pMjA3OQNmX2YFZl9mX2kFZl9mX2wHdW5pMDIzNwd6ZXJvLmxmBm9uZS5sZgZ0d28ubGYIdGhyZWUubGYHZm91ci5sZgdmaXZlLmxmBnNpeC5sZghzZXZlbi5sZghlaWdodC5sZgduaW5lLmxmCXplcm8uZG5vbQhvbmUuZG5vbQh0d28uZG5vbQp0aHJlZS5kbm9tCWZvdXIuZG5vbQlmaXZlLmRub20Ic2l4LmRub20Kc2V2ZW4uZG5vbQplaWdodC5kbm9tCW5pbmUuZG5vbQl6ZXJvLm51bXIIb25lLm51bXIIdHdvLm51bXIKdGhyZWUubnVtcglmb3VyLm51bXIJZml2ZS5udW1yCHNpeC5udW1yCnNldmVuLm51bXIKZWlnaHQubnVtcgluaW5lLm51bXIHdW5pMDMwOAlncmF2ZWNvbWIJYWN1dGVjb21iCXRpbGRlY29tYgd1bmkwMzA0B3VuaTAzMEQMZG90YmVsb3djb21iB3VuaTAzMjkEbnVsbARDUl8xB3NwYWNlXzEJdW5pMDJCQ18xC2V4Y2xhbS5kZXZhDXF1b3RlZGJsLmRldmEPbnVtYmVyc2lnbi5kZXZhDHBlcmNlbnQuZGV2YRBxdW90ZXNpbmdsZS5kZXZhDnBhcmVubGVmdC5kZXZhD3BhcmVucmlnaHQuZGV2YQ1hc3Rlcmlzay5kZXZhCXBsdXMuZGV2YQpjb21tYS5kZXZhC2h5cGhlbi5kZXZhC3BlcmlvZC5kZXZhCnNsYXNoLmRldmEJemVyby5kZXZhCG9uZS5kZXZhCHR3by5kZXZhCnRocmVlLmRldmEJZm91ci5kZXZhCWZpdmUuZGV2YQhzaXguZGV2YQpzZXZlbi5kZXZhCmVpZ2h0LmRldmEJbmluZS5kZXZhCmNvbG9uLmRldmEOc2VtaWNvbG9uLmRldmEJbGVzcy5kZXZhCmVxdWFsLmRldmEMZ3JlYXRlci5kZXZhDXF1ZXN0aW9uLmRldmEQYnJhY2tldGxlZnQuZGV2YQ5iYWNrc2xhc2guZGV2YRFicmFja2V0cmlnaHQuZGV2YRBhc2NpaWNpcmN1bS5kZXZhD3VuZGVyc2NvcmUuZGV2YQ5icmFjZWxlZnQuZGV2YQhiYXIuZGV2YQ9icmFjZXJp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ACAAbQBtACQAfQB9ACUAggCNACYAkgCSADIAlACYADMAmgCgADgAogCoAD8AqgCtAEYAsACyAEoAtAC4AE0AugC6AFIAvwDCAFMAxADFAFcAywDSAFkA1wDYAGEA6wDrAGMAAgBBAAUABQASAAoACgASAAwADAAVAA8ADwAPABAAEAATABEAEQAPACQAJAAFACYAJgACACoAKgACADIAMgACADQANAACADcANwAQADgAOAAGADkAOgALADwAPAAJAD0APQAUAEAAQAAVAEQARAAEAEUARQAIAEYASAABAEkASQAKAEoASgAOAEsASwAIAE4ATwAIAFAAUQADAFIAUgABAFMAUwADAFQAVAABAFUAVQADAFYAVgANAFcAVwAMAFgAWAADAFkAXAAHAF0AXQARAGAAYAAVAG0AbQAXAH0AfQAWAIIAhwAFAIgAiAAYAIkAiQACAJQAmAACAJoAmgACAJsAngAGAJ8AnwAJAKIAogABAKMAqAAEAKkArQABALQAuAABALoAugABALsAvgADAL8AvwAHAMAAwAAIAMEAwQAHAMMAwwAIAMQAxAACAMUAxQABAMsAzAATAM4AzgASAM8AzwAPANEA0QASANIA0gAPANQA1AAPANcA1wAXANgA2AAWAOsA7wAKAAIANwAFAAUACQAKAAoACQAPAA8AEQAQABAAEAARABEAEQAkACQAAwAmACYADAAnACcAAgAoACgABAAuAC4AEwAvAC8ACwAyADIAAgAzADMAGAA0ADQAAgA3ADcADgA4ADgABgA5ADoACgA7ADsAEwA8ADwACAA9AD0AEgBEAEQAAQBJAEkAFwBLAEsAAQBQAFEAAQBVAFUADwBXAFcADQBZAFoABQBbAFsAFABcAFwABQBtAG0AFgB9AH0AFQCCAIcAAwCIAIgABACJAIkADACKAI0ABACSAJIAAgCUAJgAAgCaAJoAAgCbAJ4ABgCfAJ8ACACgAKAAGACiAKcAAQCwALEABwC/AL8ABQDBAMEABQDCAMIACwDEAMQABADLAMwAEADNAM4ACQDPAM8AEQDQANEACQDSANIAEQDXANcAFgDYANgAFQDrAOsAFwABAGwABAAAADEBwAG2AbABmgGUAY4BTAGUAUIBlAE4AS4BKAEoAR4BtgEYAQYBKAEoASgBtgDsAZQA0gGwAbABsAGwAbABsAGO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) format('truetype');
}
:root {
--font-sans: 'Noto Sans', Arial, Helvetica, sans-serif;
}
body {
font-size: 14px;
font-family: var(--font-sans);
line-height: 1.6;
max-width: 90%;
right: 20em;
margin: 1.5em auto;
color: #222;
background-color: #fff;
scroll-behavior: smooth;
}
.subtitle {
font-size: 18pt;
font-style: italic;
}
.abstract-title {font-weight: bold; font-size: 18px;}
.abstract {margin-bottom: 3em;}
a.toplink {
float: right;
margin-right: 0.5em;
}
.btn {
font-family: Arial, Verdana, sans-serif;
background-color: #337ab7;
color: white;
font-weight: bold;
font-size: 1em;
padding: 0.5em 1.5em;
white-space: normal;
border-radius: 12px;
}
.extension-checkbox {
float: right;
opacity: 0.5;
cursor: help;
}
.container {
display: flex;
}
@media screen {
pre {
overflow-x: auto;
max-width: 100%;
max-width: calc(100% - 22px);
}
}
@media (min-width: 600px) {
.index ul {
-moz-column-count: 2;
-moz-column-gap: 20px;
}
.index ul ul {
-moz-column-count: 1;
-moz-column-gap: 0;
}
}
a.toplink {
float: right;
margin-right: 0.5em;
}
#toc {
padding: 0.75em 0 2em 0;
margin-bottom: 1em;
}
nav.toc ul {
margin: 0 0.5em 0 0;
padding: 0;
list-style: none;
}
nav.toc li {
line-height: 1.3em;
margin: 0.75em 0;
padding-left: 1.2em;
text-indent: -1.2em;
}
@media screen and (max-width: 1023px) {
body {
padding-top: 2em;
}
#title {
padding: 1em 0;
}
h1 {
font-size: 24px;
}
h2 {
font-size: 20px;
margin-top: -18px;
padding-top: 38px;
}
#identifiers dd {
max-width: 60%;
}
#toc {
position: fixed;
z-index: 2;
top: 0;
right: 0;
padding: 0;
margin: 0;
background-color: inherit;
border-bottom: 1px solid #ccc;
}
#toc h2 {
margin: -1px 0 0 0;
padding: 4px 0 4px 6px;
padding-right: 1em;
min-width: 190px;
font-size: 1.1em;
text-align: right;
background-color: #444;
color: white;
cursor: pointer;
}
#toc h2::before {
float: right;
position: relative;
width: 1em;
height: 1px;
left: -164px;
margin: 6px 0 0 0;
background: white none repeat scroll 0 0;
box-shadow: 0 4px 0 0 white, 0 8px 0 0 white;
content: "";
}
#toc nav {
display: none;
padding: 0.5em 1em 1em;
overflow: auto;
height: calc(100vh - 48px);
border-left: 1px solid #ddd;
}
}
@media screen and (min-width: 1024px) {
body {
max-width: 724px;
margin: 42px auto;
padding-left: 1.5em;
padding-right: 29em;
}
#toc {
position: fixed;
top: 42px;
right: 42px;
width: 25%;
margin: 0;
padding: 0 1em;
z-index: 1;
}
#toc h2 {
border-top: none;
border-bottom: 1px solid #ddd;
font-size: 1em;
font-weight: normal;
margin: 0;
padding: 0.25em 1em 1em 0;
}
#toc nav {
display: block;
height: calc(90vh - 84px);
bottom: 0;
padding: 0.5em 0 0;
overflow: auto;
}
img {
max-width: 100%;
height: auto;
}
}
#toc {
background-color: white;
}
@media screen and (max-width: 1023px) {
#toc h2 a,
#toc h2 a:link,
#toc h2 a:focus,
#toc h2 a:hover,
#toc a.toplink,
#toc a.toplink:hover {
color: white;
background-color: #444;
text-decoration: none;
}
}
@media screen and (min-width: 1024px) {
#toc {
padding: 0 0 1em 1em;
}
}
.section-number {
padding-right: 0.5em;
}
tt, code, pre, code {
font-size: 95%;
}
a.toplink {
float: right;
margin-right: 0.5em;
}
main {
position: relative;
order: 1;
min-width: 300px;
padding-bottom: 60em;
}
#input-search {
font-family: Arial, Verdana, sans-serif;
font-weight: normal;
font-size: 13pt;
border-radius: 24px;
}
#input-search {
border-style: none;
border: 1px solid grey;
}
#submit-search {
border-style: none;
background-color: #337ab7;
color: white;
font-family: Arial, Verdana, sans-serif;
font-size: 12pt;
font-weight: normal;
border-radius: 6px;
padding: 4px;
}
.modal {
display: none;
}
.modal.scrollable {
height: 32em;
overflow-y: scroll;
}
.modal.show {
display: block;
position: absolute;
z-index: 1;
width: 90%;
margin: auto;
background: white;
box-shadow: 0px 8px 16px 0px rgba(0,0,0,0.2);
}
.modal-header {
background-color: cyan;
margin: 0;
padding: 4pt 0pt 4pt 0pt;
font-size: 13pt;
font-weight: 600;
}
.modal-title {
}
.modal-body {
padding: 6pt;
}
header span {
font-family: Arial, Verdana, sans-serif;
}
header .big {
font-size: 36pt;
border: none;
}
header .small {
font-size: 22pt;
color: gray;
}
h1.title {
clear: both;
font-size: 28px;
padding: 1em 0 0.5em;
}
h1, h2, h3 {
padding-bottom: 3px;
border-bottom: 1px solid black;
}
h4 { font-size: 14pt;
font-weight: bold;
margin-top: 1em;
}
h1 {
font-size: 18pt;
}
h2 {
font-size: 16pt;
}
h3 {
font-size: 14pt;
}
#title, h1, h2, h3, h4, h5, h6 {
margin: 1em 0 0.5em;
font-weight: bold;
line-height: 1.3;
}
#title {
clear: both;
border-bottom: 1px solid #ddd;
margin: 0 0 0.5em 0;
padding: 1em 0 0.5em;
}
h1 {
font-size: 26px;
margin: 1em 0;
}
h2 {
font-size: 22px;
margin-top: -20px;
padding-top: 33px;
}
h3 {
font-size: 18px;
margin-top: -36px;
padding-top: 42px;
}
h4 {
font-size: 16px;
margin-top: -36px;
padding-top: 42px;
}
h5, h6 {
font-size: 14px;
}
code{
white-space: pre-wrap;
font-size: 1em;
font-family: monospace;
padding: .2em .4em;
margin: 0;
font-size: 85%;
white-space: break-spaces;
background-color: var(--color-neutral-muted);
border-radius: 6px;
background-color: #eeeeee;
}
span.nowrap code { white-space: nowrap; }
a.option code { color: inherit; }
pre{ font-size: 11pt; }
.smallcaps{font-variant: small-caps;}
.line-block{white-space: pre-line;}
.column{display: inline-block;}
q { quotes: "窶�" "窶�" "窶�" "窶�"; }
a {
color: #22e;
text-decoration: none;
}
.card-header {
background-color: #eee;
border-radius: 24px 24px 24px 24px;
padding: 3pt 6pt 3pt 6pt;
}
.show .card-header {
border-radius: 24px 24px 0px 0px;
}
.card {
padding: 0pt;
margin: 6pt;
border: 1px solid grey;
box-shadow: 0px 8px 16px 0px rgba(0,0,0,0.2);
border-radius: 24px;
}
.card-body {
padding: 6pt;
display: none;
}
.show .card-body {
display: block;
}
table {
margin-top: 1em;
margin-bottom: 1em;
}
table th {
border-bottom: 1px solid black;
}
th, td {
padding-right: 10pt;
vertical-align: top;
}
.twocol {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
}
.col {
min-width: 12em;
max-width: 22em;
}
ul ul {
margin-bottom: 0.5em
}
ul { list-style-type: square; }
dl { margin-top: auto; }
dt { font-weight: bold; margin-bottom: 0em; margin-top:1em;}
dd {
margin-left: 0em;
}
hr {
height: 1px;
color: #aaa;
background-color: #aaa;
border: 0;
margin: .2em 0 .2em 0;
}
blockquote {
padding: 0 1.6em;
color: #666;
background-color: #eeeeee;
}
footer {
padding: 1em;
color: #888;
text-align: center;
font-size: 12pt;
}
.anchor:before {
content: '迫\FE0E';
display: inline-block;
font-size: 14pt;
left: -1.75em;
line-height: 1.66;
opacity: 0.2;
padding-right: 0.5em;
position: absolute;
}
.anchor:hover {
text-decoration: none;
}
h1:hover > .anchor::before,
h2:hover > .anchor::before,
h3:hover > .anchor::before {
opacity: 1;
}
@media print {
body {
width:100% !important;
margin:0 !important;
padding:0 !important;
line-height: 1.4;
word-spacing:1.1pt;
letter-spacing:0.2pt;
font-family: "Times New Roman", serif;
color: #000;
background: none;
}
h1,h2,h3,h4,h5,h6 { font-family: Helvetica, Arial, sans-serif; }
h1{font-size:19pt;}
h2{font-size:17pt;}
h3{font-size:15pt;}
h4,h5,h6{font-size:12pt;}
pre, code { font: 10pt Courier, monospace; }
blockquote { margin: 1.3em; padding: 1em; font-size: 10pt; }
hr { background-color: #ccc; }
img { float: left; margin: 1em 1.5em 1.5em 0; }
a img { border: none; }
a:link, a:visited { background: transparent; font-weight: normal; text-decoration: underline; color:#333; }
a:link[href^="http://"]:after, a[href^="http://"]:visited:after { content: " (" attr(href) ")"; font-size: 90%; }
a[href^="http://"] {color:#000; }
table { margin: 1px; text-align:left; }
th { font-weight: bold; }
th,td { padding: 4px 10px 4px 0; }
tfoot { font-style: italic; }
caption { background: #fff; margin-bottom:2em; text-align:left; }
thead {display: table-header-group;}
tr {page-break-inside: avoid;}
.extension-checkbox { display: none; }
}
@media screen and (max-width: 1023px) {
#toc nav { display: none; }
#toc.active nav { display: block; }
}
@media print {
.toplink {
display: none;
}
#toc {
padding-top: 1px;
}
.vcard {
page-break-inside: avoid;
}
}
</style>
<!--[if lt IE 9]>
<script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
<![endif]-->
</head>
<body>
<table><tr>
<td>Working Group:</td><td>FAPI</td></tr>
<tr><td>Authors: </td>
<td>Nat Sakimura (NAT.Consulting)</td>
<td>Edmund Jay (Illumila)</td>
</tr>
<tr>
<td>Date:</td><td>2023-06-22</td>
</tr>
</table>
<header id="title-block-header">
<h1 class="title">OIDF Directives, Part 1: Principles and rules for the
structure and drafting of OIDF documents
— draft-2
</h1>
<p class="subtitle">Guidelines for drafting OIDF specifications</p>
<div class="abstract">
<div class="abstract-title">Abstract</div>
This document is a guidline to use markdown to write OIDF
specifications.
</div>
<div id="warning">
<h2 id="name-warning">
Warning
</h2>
<p>This document is not an OIDF International Standard. It is distributed for
review and comment. It is subject to change without notice and may not be
referred to as an International Standard.</p>
<p>Recipients of this draft are invited to submit, with their comments,
notification of any relevant patent rights of which they are aware and to
provide supporting documentation.</p>
</div>
</header>
<div id="toc">
<a href="#" onclick="scroll(0,0)" class="toplink">▲</a>
<h2 id="toc-title"><a href="#TOC" class="section-name selfRef">Table
of contents</a></h2>
<nav id="TOC" class="toc" role="doc-toc">
<ul>
<li><a href="#introduction" id="toc-introduction">Introduction</a></li>
<li><a href="#scope" id="toc-scope">1. Scope</a></li>
<li><a href="#normative-references" id="toc-normative-references">2.
Normative references</a></li>
<li><a href="#terms" id="toc-terms">3. Terms and definitions</a></li>
<li><a href="#abbreviations" id="toc-abbreviations">4.
Abbreviations</a></li>
<li><a href="#verbal-forms-for-expressions-of-provisions" id="toc-verbal-forms-for-expressions-of-provisions">5. Verbal forms for
expressions of provisions</a></li>
<li><a href="#structure" id="toc-structure">6. Structure of the document
body</a>
<ul>
<li><a href="#title" id="toc-title">6.1 Title</a></li>
<li><a href="#abstract" id="toc-abstract">6.2 Abstract</a></li>
<li><a href="#warning" id="toc-warning">6.3 Warning</a></li>
<li><a href="#notice" id="toc-notice">6.4 Notice</a></li>
<li><a href="#scope-clause-1" id="toc-scope-clause-1">6.5 Scope (Clause
1)</a></li>
<li><a href="#normative-references-clause-2" id="toc-normative-references-clause-2">6.6 Normative references (Clause
2)</a></li>
<li><a href="#terms-and-definitions-clause-3" id="toc-terms-and-definitions-clause-3">6.7 Terms and definitions
(Clause 3)</a></li>
<li><a href="#symbols-and-abbreviations-clause-4" id="toc-symbols-and-abbreviations-clause-4">6.8 Symbols and
abbreviations (Clause 4)</a></li>
<li><a href="#clause-5-and-after" id="toc-clause-5-and-after">6.9 Clause
5 and after</a></li>
<li><a href="#security-considerations" id="toc-security-considerations">6.10 Security considerations</a></li>
<li><a href="#privacy-considerations" id="toc-privacy-considerations">6.11 Privacy considerations</a></li>
<li><a href="#equity-considerations" id="toc-equity-considerations">6.12
Equity considerations</a></li>
<li><a href="#appendixes" id="toc-appendixes">6.13 Appendixes</a></li>
</ul></li>
<li><a href="#drafting-guidance" id="toc-drafting-guidance">7. Drafting
guidance</a>
<ul>
<li><a href="#simple-and-unambiguous-english" id="toc-simple-and-unambiguous-english">7.1 Simple and unambiguous
English</a></li>
<li><a href="#addressable-provisions" id="toc-addressable-provisions">7.2 Addressable provisions</a></li>
<li><a href="#footnotes" id="toc-footnotes">7.3 Footnotes</a></li>
<li><a href="#automatic-numbering-of-clauses" id="toc-automatic-numbering-of-clauses">7.4 Automatic numbering of
clauses</a></li>
<li><a href="#pandoc-commands" id="toc-pandoc-commands">7.5 Pandoc
commands</a></li>
</ul></li>
<li><a href="#security-considerations-1" id="toc-security-considerations-1">8. Security considerations</a></li>
<li><a href="#privacy-considerations-1" id="toc-privacy-considerations-1">9. Privacy considerations</a></li>
<li><a href="#equity-considerations-1" id="toc-equity-considerations-1">10. Equity considerations</a>
<ul>
<li><a href="#accessibility" id="toc-accessibility">10.1
Accessibility</a></li>
</ul></li>
<li><a href="#appendix-a-acknowledgement" id="toc-appendix-a-acknowledgement">Appendix A: Acknowledgement</a></li>
<li><a href="#appendix-b-bibliography" id="toc-appendix-b-bibliography">Appendix B: Bibliography</a></li>
</ul>
</nav>
</div>
<section class="note" id="section-note.1">
<h2 id="name-foreword">
Foreword
</h2>
<p>The OpenID Foundation (OIDF) promotes, protects and nurtures the OpenID community and technologies. As a non-profit international standardizing body, it is comprised by over 160 participating entities (workgroup participant). The work of preparing implementer drafts and final international standards is carried out through OIDF workgroups in accordance with the OpenID Process. Participants interested in a subject for which a workgroup has been established have the right to be represented in that workgroup. International organizations, governmental and non-governmental, in liaison with OIDF, also take part in the work. OIDF collaborates closely with other standardizing bodies in the related fields.</p>
<p>Final drafts adopted by the Workgroup through consensus are circulated publicly for the public review for 60 days and for the OIDF members for voting. Publication as an OIDF Standard requires approval by at least 50% of the members casting a vote. There is a possibility that some of the elements of this document may be subject to patent rights. OIDF shall not be held responsible for identifying any or all such patent rights.</p>
</section>
<section class="note" id="section-note.4">
<h2 id="name-notational-conventions">
Notational Conventions
</h2>
<p id="section-note.4-1">The keywords "shall", "shall not", "should", "should not", "may", and "can" in
this document are to be interpreted as described in ISO Directive Part 2
<span>[<a href="https://www.iso.org/sites/directives/current/part2/index.xhtml" class="cite xref">ISODIR2</a>]</span>. These keywords are not used as dictionary terms such that any
occurrence of them shall be interpreted as keywords and are not to be
interpreted with their natural language meanings.
They are all in lower case to rule out the dictionary meaning use of these words so that they can be translated easily.
Following is a summary of the keywords.
</p>
<p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Kind</th>
<th style="text-align: center;">Keywords</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">Requirement</td>
<td style="text-align: center;">shall, shall not</td>
</tr>
<tr class="even">
<td style="text-align: left;">Recommendation</td>
<td style="text-align: center;">should, should not</td>
</tr>
<tr class="odd">
<td style="text-align: left;">Permission</td>
<td style="text-align: center;">may</td>
</tr>
<tr class="even">
<td style="text-align: left;">Possibility</td>
<td style="text-align: center;">can, cannot</td>
</tr>
</tbody>
</table>
</p>
</section>
<h1 class="unnumbered" id="introduction">Introduction</h1>
<p>Writing clearly and unambiguously is essential for the drafting of
specifications. This document takes a best practice that we have learnt
in the past few decades and codifies them. Part 1 mainly aligns with the
ISO Directive part 2, which takes particular care of the translatability
of the document.</p>
<h1 id="scope">1. Scope</h1>
<p>The scope of this document is</p>
<ul>
<li>to provide normative requirements to the OIDF documents; and</li>
<li>to give guidance on the styles of writing such documents.</li>
</ul>
<p>The targeted audience of this document is the people who will be an
author of OIDF documents.</p>
<h1 id="normative-references">2. Normative references</h1>
<ul>
<li>ISO Directive Part 2 (2021) <a href="https://www.iso.org/sites/directives/current/part2/index.xhtml" title="ISO/IEC Directives Part 2, ISO">ISODIR2</a></li>
</ul>
<h1 id="terms">3. Terms and definitions</h1>
<p>This document uses the following terms as the shortcut for complete
wording provided as the definition. When the term appears within this
document, it should be read as being replaced by the term.</p>
<p>The format of this clause is as follows.</p>
<dl>
<dt>3.1<br />provision</dt>
<dd>
requirement and recommendation
</dd>
<dt>3.2<br />finibus</dt>
<dd>
de finibus bonorum et malorum <br /> <strong>Note to entry</strong>: This
definition is a shorthand for the title of a book by Cicero.
</dd>
</dl>
<h1 id="abbreviations">4. Abbreviations</h1>
<table>
<tbody>
<tr class="odd">
<td style="text-align: left;">HTML</td>
<td style="text-align: left;">– hypertext markup language</td>
</tr>
<tr class="even">
<td style="text-align: left;">OIDF</td>
<td style="text-align: left;">– OpenID Foundation</td>
</tr>
<tr class="odd">
<td style="text-align: left;">ISO</td>
<td style="text-align: left;">– International Standard Organization</td>
</tr>
</tbody>
</table>
<h1 id="verbal-forms-for-expressions-of-provisions">5. Verbal forms for
expressions of provisions</h1>
<p>The documents following this directive shall use the following
keywords to express requirement, recommendation, permission, and
possibility.</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Kind</th>
<th style="text-align: center;">Keywords</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">Requirement</td>
<td style="text-align: center;">shall, shall not</td>
</tr>
<tr class="even">
<td style="text-align: left;">Recommendation</td>
<td style="text-align: center;">should, should not</td>
</tr>
<tr class="odd">
<td style="text-align: left;">Permission</td>
<td style="text-align: center;">may</td>
</tr>
<tr class="even">
<td style="text-align: left;">Possibility</td>
<td style="text-align: center;">can, cannot</td>
</tr>
</tbody>
</table>
<p>Do not use “may” instead of “can”. “May” signifies permission
expressed by the document, whereas “can” refers to the ability of a user
of the document or to a possibility open to them.</p>
<p>In the cases where these keywords cannot be used for linguistic
reasons, documents can use the equivalent phrases presented in Tables 3
to 7 of <a href="https://www.iso.org/sites/directives/current/part2/index.xhtml" title="ISO/IEC Directives Part 2, ISO">ISODIR2</a>.</p>
<p>Unlike in the case of IETF, all keywords appear in small caps. This
is because mixing SHALL, Shall, and shall make it extremely difficult to
translate them into a language that does not have the notion of capital
and small cases.</p>
<p>This means these keywords cannot be used in dictionary senses, which
makes it possible to write more precisely.</p>
<p>NOTE: Alternatively, you may use RFC2119 keywords if you are drafting
in IETF style. Just be mindful not to use small case versions of these
keywords as it will make it difficult to translate.</p>
<h1 id="structure">6. Structure of the document body</h1>
<h2 id="title">6.1 Title</h2>
<p>Title is a mandatory element.</p>
<ol type="1">
<li><p>Title shall have “draft” or “implementer’s draft” when it is not
final.</p></li>
<li><p>Title should have its version number.</p></li>
<li><p>While the document is still not final, the title shall not have
“OpenID” in it except when it is an extension/profile/binding of
existing OpenID final specifications.</p>
<p>Example: An entirely new (hypothetical) protocol draft “Avian
carriers” is not allowed to use “OpenID Avian carriers” as its title,
while “Avian carriers binding for OpenID Connect” is allowed.</p></li>
</ol>
<p>This entry is not numbered.</p>
<h2 id="abstract">6.2 Abstract</h2>
<p>Abstract is an element that explains the content briefly. It is an
optional element.</p>
<p>This entry is not numbered.</p>
<h2 id="warning">6.3 Warning</h2>
<p>This is a mandatory element while the document is still a draft or
implementer’s draft.</p>
<ol type="1">
<li>The document shall show the text as in this document.</li>
</ol>
<p>This entry is not numbered. When the correct template is used with
pandoc, it will be automatically inserted.</p>
<h2 id="notice">6.4 Notice</h2>
<p>This is a mandatory element for all drafts, implementer’s drafts, and
final specifications.</p>
<ol type="1">
<li>The document shall show the text as in this document.</li>
</ol>
<p>When the correct template is used with pandoc, it will be
automatically inserted.</p>
<h2 id="scope-clause-1">6.5 Scope (Clause 1)</h2>
<p>Clause 1 shall always be “1. Scope”. This clause explains what is in
this document concisely and the targeted audience.</p>
<p>The scope clause gives the readers a compact description of what this
document provides. Typically, it is drafted as a sentence split into
several bullet points.</p>
<p>See clause 1 of this document to see an example.</p>
<p>This clause is mandatory.</p>
<h2 id="normative-references-clause-2">6.6 Normative references (Clause
2)</h2>
<p>Clause 2 shall always be “2. Normative references”. This clause lists
all the documents that are essential to implement the requirements in
this document. All other references shall be recorded in the Informative
reference section at the end of this document.</p>
<p>Normative references section provides the list of documents that are
essential to fulfil the requirements in this document. In other words,
all the documents that are referred to with a “shall” shall be listed in
this section.</p>
<p>Also, if the document includes the definition of another document,
the document cannot be read without the included document. Therefore,
such documents go into the normative reference.</p>
<p>This clause is mandatory.</p>
<h2 id="terms-and-definitions-clause-3">6.7 Terms and definitions
(Clause 3)</h2>
<ol type="1">
<li>Clause 3 shall always be “3. Terms and definitions”. This clause is
mandatory.</li>
<li>The first paragraph of clause 3 shall be the paragraph in Figure
1.</li>
</ol>
<blockquote>
<p>This document uses the following terms as the abbreviation for
complete wording provided as the definition. When the term appears
within this document, it should be read as being replaced by the
term.</p>
</blockquote>
<p>Figure 1 — The first paragraph in clause 3</p>
<p>NOTE: it will be automatically inserted if draft-template.html is
used as the template for pandoc processing.</p>
<p>What this means is that if a term “finibus” was defined as “De
Finibus Bonorum et Malorum”, then if “finibus” appeared in the text, it
will be replaced with “De Finibus Bonorum et Malorum”. For example, when
the text was:</p>
<blockquote>
<p>Lorem ipsum is typically a corrupted version of Cicero’s “finibus”,
with words altered, added, and removed to make it nonsensical, improper
Latin.</p>
</blockquote>
<p>a reader will read it as:</p>
<blockquote>
<p>Lorem ipsum is typically a corrupted version of Cicero’s “De Finibus
Bonorum et Malorum”, with words altered, added, and removed to make it
nonsensical, improper Latin.</p>
</blockquote>
<p>When there is ambiguity in the dictionary meaning of a term, it would
be necessary to specify which definition is to be used in the document.
For this, the editors should create an entry into clause 3.</p>
<ol start="3" type="1">
<li>An entry shall have the entry number as the first line, the
preferred term as the second line, synonyms in the following lines, and
the definition text in the following line.</li>
</ol>
<p>EXAMPLE:</p>
<dl>
<dt>3.10<br />claims provider<br />attribute provider</dt>
<dd>
IIP that provides attributes claiming they are true
</dd>
</dl>
<p>When a term is defined, then any occurrence of the term should be
able to be replaced by the definition. Because of this, there are
several requirements on how terms and definitions are to be drafted.</p>
<p>A term</p>
<ol start="4" type="1">
<li>shall always be the small case;</li>
<li>shall be in the singular form, and</li>
<li>shall only appear here if it is used in the main text.</li>
</ol>
<p>A definition</p>
<ol start="7" type="1">
<li>shall not start with an article;<br />
</li>
<li>shall not end with a punctuation mark; and</li>
<li>should be short.</li>
</ol>
<p>It is advisable not to define a single word as it will make it not
possible to use the word in a dictionary sense.</p>
<ol start="10" type="1">
<li>A verb should not be defined. Instead, the noun form should be
defined.</li>
<li>The order of appearance of the terms shall not be alphabetic, as it
will become meaningless when translated into another language.</li>
<li>The order of appearance should be</li>
</ol>
<ul>
<li>according to the semantic relationship; or</li>
<li>according to the appearance order in the document.</li>
</ul>
<p>Editors are advised to replace all the defined terms in the document
with the respective definitions and see if it reads well.</p>
<h2 id="symbols-and-abbreviations-clause-4">6.8 Symbols and
abbreviations (Clause 4)</h2>
<ol type="1">
<li>This clause’s title shall be one of the following according to the
content of the clause.
<ol type="i">
<li>Symbols and abbreviations</li>
<li>Symbols</li>
<li>Abbreviations</li>
</ol></li>
<li>All the symbols and abbreviations that appear in this document shall
appear here.</li>
</ol>
<p>This clause is optional.</p>
<h2 id="clause-5-and-after">6.9 Clause 5 and after</h2>
<p>The main content of the text appears in clause 5 and after. It can
span multiple clauses and subclauses.</p>
<p>When concepts are needed to be explained, do it here and after. Do
not explain concepts in terms and definitions.</p>
<ol type="1">
<li>All figures and tables shall be numbered.</li>
<li>The document shall have text pointing to these tables and
figures</li>
<li>Hanging paragraphs are not allowed as it will be difficult to
differentiate if the pointer like 5.3 refers to the hanging pargraph or
the entire 5.3.</li>
</ol>
<h2 id="security-considerations">6.10 Security considerations</h2>
<p>Security considerations is a mandatory clause.</p>
<ol type="1">
<li>It should list out the security assumptions etc.</li>
</ol>
<h2 id="privacy-considerations">6.11 Privacy considerations</h2>
<p>Privacy considerations are a mandatory clause.</p>
<ol type="1">
<li>The clause should list the potential privacy impacts that the
deployment of the specification potentially causes.</li>
</ol>
<h2 id="equity-considerations">6.12 Equity considerations</h2>
<p>When appropriate, authors should write a clause on equity
considerations. Considerations on accessibility, possible biases, etc.
usually goes in here.</p>
<h2 id="appendixes">6.13 Appendixes</h2>
<p>Appendixes are used to collect and present data, examples, etc. It is
customary to list contributors in one of the appendices, so a document
usually has at least one appendix.</p>
<p>During the drafting period, change history is also collected in the
appendix.</p>
<ol type="1">
<li>Appendixes shall be labelled as Appendix A, Appendix B, etc.</li>
<li>The last appendix shall be the bibliography.</li>
<li>The second last appendix shall be the acknowledgement.</li>
<li>For drafts, third last appendix shall be document history, which
will be removed from the final publication.</li>
</ol>
<h1 id="drafting-guidance">7. Drafting guidance</h1>
<h2 id="simple-and-unambiguous-english">7.1 Simple and unambiguous
English</h2>
<p>When drafting the document, the editor should make sure that the
language is simple and clear. This is particularly important as it will
be a second language for many readers. In many cases, they have to rely
on translations, and translations become harder as the sentence
complexity rises.</p>
<p>To achieve the above goal, editors</p>
<ol type="1">
<li>should not use passive form;</li>
<li>should make a sentence short;</li>
</ol>
<h2 id="addressable-provisions">7.2 Addressable provisions</h2>
<p>When showing compliance to a specification, one needs to be able to
point to the provision exactly.</p>
<p>To achieve it, labelling them with a unique identifier is useful.
Therefore,</p>
<ol type="1">
<li>one paragraph or list item shall have only one provision</li>
<li>the paragraph or list item shall be numbered or labelled.</li>
</ol>
<p>Readers can refer to these provisions as 7.2-1 and 7.2-2.</p>
<p>It is possible to insert a paragraph, and then continue the
numbers.</p>
<ol start="3" type="1">
<li>This line should appear as line item 3.
<ol type="i">
<li>subdivisions i.</li>
<li>subdivisions ii.</li>
</ol></li>
<li>This line should appear as line item 4.</li>
</ol>
<h2 id="footnotes">7.3 Footnotes</h2>
<p>Footnotes are possible. For example, RFC6749<a href="#fn1" class="footnote-ref" id="fnref1" role="doc-noteref"><sup>1</sup></a> can
have the footnote as in this example.</p>
<h2 id="automatic-numbering-of-clauses">7.4 Automatic numbering of
clauses</h2>
<p>Automatic numbering of clauses and subclauses are possible. To do so,
use ‘-N’ commandline option for pandoc.</p>
<p>When using automatic numbering, make sure to put {.unnumbered} or {-}
selector for the “Introduction”.</p>
<h2 id="pandoc-commands">7.5 Pandoc commands</h2>
<p>To create an HTML version of the document, use the following pandoc
command.</p>
<pre><code>% pandoc --toc -c site.css --template=draft-template.html -f markdown -t html -s --embed-resources -o outputfile.html inputfile.md </code></pre>
<p>where</p>
<ul>
<li>outputfile.html is a path to the output file</li>
<li>inputifle.md is the source code markdown file</li>
<li>draft-template.html is the OIDF template file that has legal notices
etc.</li>
<li>site.css is the CSS file to be embedded in the outputfile.html</li>
</ul>
<h1 id="security-considerations-1">8. Security considerations</h1>
<p>Make sure that you are using the correct pandoc installation to
convert the markdown file to HTML. If a compromised pandoc installation
is used, it is possible that a malware code is to be included in the
generated HTML file.</p>
<h1 id="privacy-considerations-1">9. Privacy considerations</h1>
<p>This document contains the authors’ and contributors’ names and
contact.</p>
<ol type="1">
<li>They should be appropriately hidden before making it public.</li>
</ol>
<h1 id="equity-considerations-1">10. Equity considerations</h1>
<h2 id="accessibility">10.1 Accessibility</h2>
<ul>
<li>This document is readable using a screen reader.</li>
<li>This document is easier to process through a screen reader as it is
not using cases to convey special meanings.</li>
<li>This document is easy to translate as it is not using cases to
convey special meanings.</li>
<li>This document is provided as a self-contained HTML so it can be read
by those without an internet connection.</li>
</ul>
<h1 class="unnumbered" id="appendix-a-acknowledgement">Appendix A:
Acknowledgement</h1>
<p>This document was developed by OpenID Foundation.</p>
<p>Without the contribution of the following people, this document would
not have been created.</p>
<p><strong>Authors/Editors</strong></p>
<ul>
<li>Nat Sakimura, NAT Consulting <a href="mailto:nat@nat.consulting" class="email">nat@nat.consulting</a></li>
<li>Edmund Jay, Illumila <a href="mailto:ejay@mgi1.com" class="email">ejay@mgi1.com</a></li>
</ul>
<p><strong>Contributors</strong></p>
<ul>
<li>Alice Wonderland, Fairlytale</li>
<li>Bob Spongy, Cartoon</li>
</ul>
<h1 class="unnumbered" id="appendix-b-bibliography">Appendix B:
Bibliography</h1>
<section id="footnotes" class="footnotes footnotes-end-of-document" role="doc-endnotes">
<hr />
<ol>
<li id="fn1"><p>RFC6749 - Hardt, D.:OAuth Authorization Framework 2.0<a href="#fnref1" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
</ol>
</section>
</div>
<div id="notices">
<h2 id="name-notices">
Notices
</h2>
<p>Copyright (c) 2023 The OpenID Foundation.</p>
<p>The OpenID Foundation (OIDF) grants to any Contributor, developer, implementer, or other interested party a non-exclusive, royalty free, worldwide copyright license to reproduce, prepare derivative works from, distribute, perform and display, this Implementers Draft or Final Specification solely for the purposes of (i) developing specifications, and (ii) implementing Implementers Drafts and Final Specifications based on such documents, provided that attribution be made to the OIDF as the source of the material, but that such attribution does not indicate an endorsement by the OIDF.</p>
<p>The technology described in this specification was made available
from contributions from various sources, including members of
the OpenID Foundation and others.
Although the OpenID Foundation has taken steps to help ensure that
the technology is available for distribution, it takes no position
regarding the validity or scope of any intellectual property or other
rights that might be claimed to pertain to the implementation or use of
the technology described in this specification or the extent to which
any license under such rights might or might not be available; neither
does it represent that it has made any independent effort to identify
any such rights. The OpenID Foundation and the contributors to
this specification make no (and hereby expressly disclaim any)
warranties (express, implied, or otherwise), including implied
warranties of merchantability, non-infringement, fitness for a particular
purpose, or title, related to this specification, and the entire risk as
to implementing this specification is assumed by the implementer.
The OpenID Intellectual Property Rights policy requires contributors to offer
a patent promise not to assert certain patent claims against other contributors
and against implementers. The OpenID Foundation invites any interested party to
bring to its attention any copyrights, patents, patent applications,
or other proprietary rights that may cover technology
that may be required to practice this specification.</p>
</div>
<script>const toc = document.getElementById("toc");
toc.querySelector("h2").addEventListener("click", e => {
toc.classList.toggle("active");
});
toc.querySelector("nav").addEventListener("click", e => {
toc.classList.remove("active");
});
</script>
</body>
</html>