<div dir="auto">I think that depends on how you define “spec”. I think Markdown is good for the “prose bits”, while there could be something more formal for the structural bits. </div><div dir="auto"><br></div><div dir="auto">I think there may be some approaches that are akin to literate programming, where data structures are expressed using a formal notation while explanations are expressed in something prose-like. Those two threads can interweave, and suitable tools can build either human-readable documents or some machine-readable notation. </div><div dir="auto"><br></div><div dir="auto">A.</div><div dir="auto"><br></div><div dir="auto"><br></div><div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, 21 Sep 2020 at 17:54, Peter Constable <<a href="mailto:pgcon6@msn.com">pgcon6@msn.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;padding-left:1ex;border-left-color:rgb(204,204,204)">Markdown is a pain for the spec. It's just less of a pain than HTML.<br><br><br><br>-----Original Message-----<br><br>From: mpeg-otspec <<a href="mailto:mpeg-otspec-bounces@lists.aau.at" target="_blank">mpeg-otspec-bounces@lists.aau.at</a>> On Behalf Of Werner LEMBERG<br><br>Sent: Monday, September 21, 2020 7:22 AM<br><br>To: <a href="mailto:list.adam@twardoch.com" target="_blank">list.adam@twardoch.com</a><br><br>Cc: <a href="mailto:mpeg-otspec@lists.aau.at" target="_blank">mpeg-otspec@lists.aau.at</a><br><br>Subject: Re: [MPEG-OTSPEC] Proposal to discontinue the AdHoc Group<br><br><br><br><br><br>> Those technical documents (the spec plus other documentation) should <br><br>> be treated like code. On Github, when I go like “well, that bit, <br><br>> maybe, blah...” on some repo, the maintainer will often say “make a <br><br>> pull request, then we’ll review it”.<br><br><br><br>Yes!  I think that the Markdown format is good enough for the specification; if necessary we could use Pandoc extensions (in addition to what GitHub provides), for example.<br><br><br><br>In case it is not sufficient there are easy solutions to improve formatting by adding proper comments here and there that a postprocessor script could handle.<br><br><br><br><br><br>    Werner<br><br>_______________________________________________<br><br>mpeg-otspec mailing list<br><br><a href="mailto:mpeg-otspec@lists.aau.at" target="_blank">mpeg-otspec@lists.aau.at</a><br><br><a href="https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Flists.aau.at%2Fmailman%2Flistinfo%2Fmpeg-otspec&amp;data=02%7C01%7C%7Cd9a387be877b44af2dd308d85e39b563%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C637362949241825735&amp;sdata=tyGjDUI8cpenlLgAiYsTpHtckTLZF80yof5bmfchp1I%3D&amp;reserved=0" rel="noreferrer" target="_blank">https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Flists.aau.at%2Fmailman%2Flistinfo%2Fmpeg-otspec&amp;data=02%7C01%7C%7Cd9a387be877b44af2dd308d85e39b563%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C637362949241825735&amp;sdata=tyGjDUI8cpenlLgAiYsTpHtckTLZF80yof5bmfchp1I%3D&amp;reserved=0</a><br><br></blockquote></div></div>