On Tue, 22 Apr 2025 21:01:13 GMT, Chen Liang <li...@openjdk.org> wrote:

>> In the new design, the above "footnotes" go at the bottom.  They explain why 
>> the rules prescribed at the top are important.  In effect, inform aggressive 
>> implementors how far they may bend those rules.  Sometimes the rules do get 
>> bent, sometimes to allow unspecified behavior, but never so far as to allow 
>> a type safety violation.
>
> I still believe these information are important and better kept inline; 
> inlined them with blockquote tags.

+1 from me on your preference.  In formulating footnotes I was trying to 
respect your attempt to put the most important bits at the top.  I actually 
prefer the "sidebars" (what you have) to "footnotes".

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/24777#discussion_r2054895659

Reply via email to