<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sat, Jul 27, 2019 at 12:35 AM Matthias Klumpp <<a href="mailto:matthias@tenstral.net">matthias@tenstral.net</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">Am Fr., 26. Juli 2019 um 05:32 Uhr schrieb Robert Ancell<br>
<<a href="mailto:robert.ancell@canonical.com" target="_blank">robert.ancell@canonical.com</a>>:<br>
><br>
> I propose we add the following:<br>
> - emphasis <em><br>
<br>
The <em> emphasis is already scheduled for addition, we had a really<br>
long discussion about this particular one in<br>
<a href="https://github.com/ximion/appstream/issues/184" rel="noreferrer" target="_blank">https://github.com/ximion/appstream/issues/184</a></blockquote><div><br></div><div>Nice! <br></div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
> - strong emphasis <strong><br>
<br>
I am not so sure about this one - isn't a regular emphasis enough?<br>
</blockquote><div><br></div><div>In HTML regular emphasis is italics by default and strong bold. I think you could get away with one level of emphasis, but it's probably a good idea to align with HTML/Markdown and support two.<br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
> - code <code> or <pre> or <pre><code> (CommonMark uses options 1 and 3, but it's probably simpler to just only <code> or <pre> in AppStream. I'm not enough of an XML expert to work out the differences between these tags).<br>
<br>
<code> makes sense to me, if it isn't overused. Would code be inline<br>
monospace, or rather be a code block?<br></blockquote><div><br></div><div>CommonMark supports both [1] [2] and I think both are useful, but you could probably use a single tag to express both, i.e.:</div><div><br></div><div><p><br></div><div>The name <code>foo</code> is commonly used as a placeholder, e.g.:</div><div></p></div><div><p><code></div><div>int foo = 5;<br></div><div></code></p></div><div><br></div><div>As Simon pointed out staying close to HTML is probably a good idea to avoid confusion. I guess that would mean supporting both <code> and <pre>.<br></div><div><br></div><div>[1] <a href="https://spec.commonmark.org/0.29/#code-spans">https://spec.commonmark.org/0.29/#code-spans</a></div><div>[2] <a href="https://spec.commonmark.org/0.29/#indented-code-blocks">https://spec.commonmark.org/0.29/#indented-code-blocks</a></div></div></div>