<div dir="ltr">I like the idea of markdown, if possible.<div>It is simple and gets the job done.</div><div>Would processing it be more cumbersome than the alternatives?</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Feb 26, 2020 at 8:43 PM Alex Rousskov <<a href="mailto:rousskov@measurement-factory.com">rousskov@measurement-factory.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On 2/25/20 1:31 AM, Amos Jeffries wrote:<br>
<br>
> Any suggestions of formats I should look at then?<br>
<br>
I believe cf.data.pre should use two primary formats, each optimized<br>
specifically for the content it is applied to. The secondary details of<br>
each format will evolve, but here is where I would start today:<br>
<br>
1. YAML-like metadata to supply formal details about each directive. We<br>
already use this today, and I expect no significant changes in the<br>
immediate future (even though many improvements are possible in this area!).<br>
<br>
2. Markdown for informal documentation inside DOC_START...DOC_END,<br>
DEFAULT_DOC, and similar text blocks. Preprocessing includes validation<br>
of internal references (for sure), generation of internal anchors<br>
(probably), and removal of minimal common indentation (not sure; need to<br>
experiment/discuss). Other preprocessing actions may be desirable as<br>
well, of course. An agreement on the lower-level details and a<br>
non-trivial conversion effort would be required. We can discuss whether<br>
to do it incrementally or once-and-for-all.<br>
<br>
<br>
HTH,<br>
<br>
Alex.<br>
_______________________________________________<br>
squid-dev mailing list<br>
<a href="mailto:squid-dev@lists.squid-cache.org" target="_blank">squid-dev@lists.squid-cache.org</a><br>
<a href="http://lists.squid-cache.org/listinfo/squid-dev" rel="noreferrer" target="_blank">http://lists.squid-cache.org/listinfo/squid-dev</a><br>
</blockquote></div><br clear="all"><div><br></div>-- <br><div dir="ltr" class="gmail_signature">    Francesco</div>