<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;">
<div>
<blockquote type="cite">
<div>On 28 Apr 2025, at 17:28, Mark Reinhold <mark.reinhold@oracle.com> wrote:</div>
<br class="Apple-interchange-newline">
<div>
<div>2025/4/28 6:33:20 -0400, magnus.ihse.bursie@oracle.com:<br>
<blockquote type="cite">...<br>
<br>
I don't think we need to overthink this. Is there anything stopping <br>
anyone from starting to use this straight away? Any kind of additional <br>
structures/guidelines etc can be added later on, if this turns out to be <br>
so well-used it gets overcrowded.<br>
</blockquote>
<br>
Do we need to overthink this? No.<br>
<br>
But any proposal for a new convention for all of JDK development,<br>
if it is to succeed, needs at least a rough consensus behind it.<br>
<br>
I don’t, so far, see such a consensus.<br>
</div>
</div>
</blockquote>
<div><br>
</div>
<div>This discussion seems to have taken a turn towards a different type of documentation than what I interpreted the initial question was about. When I read "<span style="caret-color: rgb(0, 0, 0); color: rgb(0, 0, 0);">supporting documents to</span></div>
<span style="caret-color: rgb(0, 0, 0); color: rgb(0, 0, 0);">justify a change", that's what I replied to. I still think these would be best off attached to the JBS issue. I would not like to see various spreadsheet files with benchmark data or images with
graphs etc committed to the source code.</span></div>
<div><span style="caret-color: rgb(0, 0, 0); color: rgb(0, 0, 0);"><br>
</span></div>
<div><font color="#000000"><span style="caret-color: rgb(0, 0, 0);">If we talk about descriptions of how the code is implemented, documentation for developers who need to understand subsystems in order to work on the code, then yes, I think it's totally reasonable
to have that in markdown files in the source tree.</span></font></div>
<div><font color="#000000"><span style="caret-color: rgb(0, 0, 0);"><br>
</span></font></div>
<div><font color="#000000"><span style="caret-color: rgb(0, 0, 0);">At least in my mind these are two different types of documents. Sorry if that's just me :-)</span></font></div>
<div><span style="caret-color: rgb(0, 0, 0); color: rgb(0, 0, 0);">/Jesper</span></div>
<div><font color="#000000"><span style="caret-color: rgb(0, 0, 0);"><br>
</span></font></div>
</body>
</html>