<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"></head><body style="overflow-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;">Hi Archie,<div><br></div><div>Moving to guide-dev which seems more appropriate for this discussion. Also including Marc who has more experience working with release notes.</div><div><br></div><div>/Jesper<br><div><br><blockquote type="cite"><div>On 13 Apr 2023, at 15:31, Archie Cobbs <archie.cobbs@gmail.com> wrote:</div><br class="Apple-interchange-newline"><div><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><div dir="ltr">Not sure where to send this question, so my apologies for any misdirection...<br clear="all"><div><br></div><div>There seems to be some discrepancy in the syntax specification for release notes, at least with regards to backslashes.</div><div><br></div><div>Take <a href="https://bugs.openjdk.org/browse/JDK-8304995">JDK-8304995</a> for example. The end result is supposed to contain an example that looks like this:</div><div><br><span style="font-family:monospace">
public class Test {
<br>
interface Cafe\u0301 {
<br>
}
<br>
interface Caf\u00e9 {
<br>
}
<br>
} <br></span></div><div><br></div><div>Note the single backslashes in there.</div><div><br></div><div>The <a href="https://bugs.openjdk.org/browse/JDK-8304995">corresponding JIRA issue</a> description contains only single backslashes.</div><div><div><br></div><div>The JDK developer's guide says: "While the markdown won’t be rendered in
JBS, you can use <a href="https://spec.commonmark.org/dingus/">dingus</a> to see what the
release note will look like."</div><br></div><div>When the JIRA description text is copied and pasted into <a href="https://daringfireball.net/projects/markdown/dingus">dingus</a> (or the other <a href="https://spec.commonmark.org/dingus/">dingus</a>) the single blackslashes appear correctly.</div><div><br></div><div>However, in the <a href="https://jdk.java.net/21/release-notes">current release notes</a> the backslashes are missing.</div><div><br></div><div>It appears that the statement "you can use dingus to see what the
release note will look like" is not really correct.</div><div><br></div><div>Where is the breakdown here?<br></div><div><br></div><div>Thanks,</div><div>-Archie<br></div><div><br><span class="gmail_signature_prefix">-- </span><br><div dir="ltr" class="gmail_signature" data-smartmail="gmail_signature">Archie L. Cobbs<br></div></div></div>
</div></blockquote></div><br></div></body></html>