<table border="1" cellspacing="0" cellpadding="8">
<tr>
<th>Issue</th>
<td>
<a href=https://github.com/llvm/llvm-project/issues/54965>54965</a>
</td>
</tr>
<tr>
<th>Summary</th>
<td>
Change of policy on release notes appears to be undocumented
</td>
</tr>
<tr>
<th>Labels</th>
<td>
documentation
</td>
</tr>
<tr>
<th>Assignees</th>
<td>
</td>
</tr>
<tr>
<th>Reporter</th>
<td>
hvdijk
</td>
</tr>
</table>
<pre>
In <https://reviews.llvm.org/D122663>, @erichkeane writes:
> Our most recent direction is to document any non-NFC patches in the release notes if at all sensible [...]
This is a sensible policy and one that I have no issue with. However, it is not one that has been used in the past and I cannot find any documentation to support it. The only documentation on release notes that I can find is at <https://llvm.org/docs/DeveloperPolicy.html>, which only states:
> Documentation: Any changes to the C API are required to be documented in the release notes so that it’s clear to external users who do not follow the project how the C API is changing and evolving.
An explicit statement that all changes to X are required to be documented in the release notes implies that changes not to X are not generally required to be documented in the release notes except in special cases. I would expect a change to policy to be accompanied by an update to that document, or alternatively to <https://llvm.org/docs/CodingStandards.html>.
</pre>
<img width="1px" height="1px" alt="" src="http://email.email.llvm.org/o/eJydVMFy2jAQ_Rr7shOPsYHggw8UkimXNjPtoVdZXpASIbmSDMnfdyXbAZoe2s54wOuV3r63b6XGtG_1TkNSboT3nUvKdVI80mPxJPHsMqVOx8zYA33azopiuSyT8iEpNpDMc7SSixdkGuFspce4O98m-fRbPsDX3sLROA8WOWoPraQXL40G6cAbaA3vjyHB9Btoo---PG6gY54LdCA1eIG0VSFzSGkfPu6B0XKlwKF2slEIyeJTlmXJYntd_bugCvSwy7rOKMnfqFQLhkh7QUA7EOwUsGmt60mJ9CKDz-aMJ7RBqPQBhWpf9gjmoEHU0DtsJ5Ydcz5C74AzHdbvJUVB1ySSReGk2vVdZywB-wy-016j1e-r6LnVPbIl7AE4SPMfjbsyjABd8I2UKNOhfYryM-GPajTxLMjBobqjun90cHtNi_KwJkVcMH3A6GDQvoH10w6YDV797MniNmQafNd0adOtKGcGXdInD0WyypOqcsBphQ0A-OrRaqZCn60jtmFeohV7o5Q5D3235plGCsQYD1yoO5Gj1IdoCp6MOlGQXctbayrRUVPI46g_TmIkFObrSuSP_xEnj4Q9OTeBBfbvgCE4oEZL5d7-FR5fOXY-5FyHXFKbOCVdRkNyNr1qg7bQGDbWDrDjCRgKMM7NsWNaUoUmHAvou5a6MLhKnCcGYVSMpZ5EO7ykeYoYfzF8G9NS17958oDZ1k3Dl6VtXbZVWbHUS6-w3gwUzX6i-GH-WdfRWLiRe68v7Ul7q-pbIgc6xX2Tkb6R1fh3N04LhfG4B4qLebVcpKJerfh-ycs8L2az6r4pmz0iFrPFYl5yjlilijWoXE23TVIUN6eVYrp9UlkXeVHk89lqtloUeZXd5-Vq3xTNbFUxnJdNuDSPTKr3azW1daTV9AdHSSWdv9y5KXNOHjRiLEn4rPfC2FqcWvn8kkYBdWT_CwWx-ro">