
<html><head><meta http-equiv="Content-Type" content="text/html charset=us-ascii"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">Hi all,<div class="">And cc'ing flac-dev.</div><div class=""><br class=""><div><blockquote type="cite" class=""><div class="">On May 10, 2017, at 12:15 PM, Dave Rice <<a href="mailto:dave@dericed.com" class="">dave@dericed.com</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><meta http-equiv="Content-Type" content="text/html charset=us-ascii" class=""><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">Hi Andrew,<div class=""><br class=""><div class=""><blockquote type="cite" class=""><div class="">On May 10, 2017, at 11:19 AM, Andrew James Weaver <<a href="mailto:weevz@uw.edu" class="">weevz@uw.edu</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div dir="ltr" class="">Hello all!<div class=""><br class=""></div><div class="">In a previous discussions on this list about people interested in working on the FLAC standard, I said that I would be willing to start the process of converting the existing standard into Markdown. I am writing to inform the list that I have begun preliminary work on this conversion.</div><div class=""><br class=""></div><div class="">Currently that work is living here <a href="https://github.com/privatezero/flac_markdown" class="">https://github.com/privatezero/flac_markdown</a>.</div></div></div></blockquote><br class=""></div><div class="">I sent a pull request at <a href="https://github.com/privatezero/flac_markdown/pull/1" class="">https://github.com/privatezero/flac_markdown/pull/1</a>, which starts to add a process to convert the markdown to the RFC format using the same Makefile approach that we use with the FFV1 and EBML markdown files. There's still a lot of inter-document cross-referencing that needs to be adjusted before the Makefile works. For instance current cross-referencing like:</div><div class=""><br class=""></div><div class="">[*SUBFRAME\_VERBATIM*](#subframe_verbatim)</div><div class=""><br class=""></div><div class="">won't render as expected in a plain text RFC, but would simply render to something like "Section X.X.X".</div><div class=""><br class=""></div><div class="">In EBML we use markdown such as</div><div class=""><pre class=""><pre class="">See [the section on `Element Data Size`](#element-data-size) for rules that apply to elements of unknown length.</pre></pre><div class="">so that in the RFC this renders to</div><div class=""><pre class="">See Section 7 for rules that apply to elements of unknown length.</pre><div class="">and in the markdown it renders to</div></div><div class=""><br class=""></div><div class="">See <a href="https://github.com/Matroska-Org/ebml-specification/blob/master/specification.markdown#element-data-size" class="">the section on <code class="">Element Data Size</code></a> for rules that apply to elements of unknown length.</div></div></div></div></div></blockquote><br class=""></div><div>I added some issues to the flac_markdown repository and Andrew addressed them in <a href="https://github.com/privatezero/flac_markdown/pull/7" class="">https://github.com/privatezero/flac_markdown/pull/7</a>. Most of these issues pertain to unintended semantic differences between the FLAC specification as it exists in its original HTML form at <a href="https://xiph.org/flac/format.html" class="">https://xiph.org/flac/format.html</a> and the markdown rendition being worked on at <a href="https://github.com/privatezero/flac_markdown/blob/master/flac.md" class="">https://github.com/privatezero/flac_markdown/blob/master/flac.md</a>.</div><div><br class=""></div><div>Since the recent work focuses on a change of format from HTML to markdown, I suggest that short term goals on the flac specification focus on:</div></div><div>- verifying semantic equalness with the html version</div><div>- resolving issues that block the mmark/xml2rfc process that generates the RFC formats of the specification</div><div>- add standard RFC boilerplate (abstract, rfc2119, etc)</div><div><br class=""></div><div>Dave Rice</div></body></html>