<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Jul 29, 2019 at 11:07 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 So., 28. Juli 2019 um 20:29 Uhr schrieb Richard Hughes <<a href="mailto:hughsient@gmail.com" target="_blank">hughsient@gmail.com</a>>:<br>
><br>
> On Sun, 28 Jul 2019 at 07:47, Robert Ancell <<a href="mailto:robert.ancell@canonical.com" target="_blank">robert.ancell@canonical.com</a>> wrote:<br>
> > I guess that would mean supporting both <code> and <pre>.<br>
><br>
> I think various things would break trying to support <pre> -- a lot of<br>
> current and legacy tools that import and export AppStream assume that<br>
> XML whitespace isn't important. My vote would be to add <code>, <em><br>
> and <strong> and leave it at that.<br>
<br>
The reason why I was asking about whether <code/> meant a code-block<br>
or a single-line markup was more about the intent of Robert for how<br>
this should be used. Diverging from HTML makes not much sense, as that<br>
would yield unexpected results. Aligning with Mallard or Docbook XML<br>
is the one thing that could also make sense (but not inventing our own<br>
stuff).<br>
<br>
+1 from me for <code/> and <em/> as they were discussed here (I<br>
already have a commit to add <em/>, but libappstream currently has a<br>
bunch of validator changes staged that I want to land first). I am<br>
unsure about <strong/> (wouldn't that just be visual clutter?) and<br>
especially about code blocks. The thing I want to avoid is the<br>
description texts becoming manual pages or detailed instructions with<br>
code examples, as README.md files often are. Allowing code blocks may<br>
make it more likely that descriptions will become instructions.<br>
<br></blockquote><div><br></div><div>What's the next step here; should I make an MR for <code/> to be added to the specification? <br></div><div><br></div><div>I figure this discussion would have worked better as a GitHub issue? It might be worth opening issues for <strong/> and <pre/> so we have a better record of the reasoning for/against.<br></div></div></div>