On Tue, 14 Apr 2026 14:00:35 GMT, James Nord <[email protected]> wrote:

>> The [existing 
>> documentation](https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/net/URL.html#constructor-deprecation)
>>  when rendered was hard to read as the entire string was in a `pre` and 
>> rendered in the same font.  Coupled with the fact the the first URL would 
>> contain a space this made it hard to scan as you had no visual clues and had 
>> to backtrack to re-read what the sentence was trying to say.
>> 
>> Switch to using inline definition using {@code} and swapped the order so 
>> that the string without spaces came first negating any need for back 
>> tracking when scanning
>> 
>> - [x] I confirm that I make this contribution in accordance with the 
>> [OpenJDK Interim AI Policy](https://openjdk.org/legal/ai).
>
> James Nord has updated the pull request incrementally with one additional 
> commit since the last revision:
> 
>   8381184: remove whitespace from snippets

> 
@jtnord, are you planning to integrate this change?

@vy I have attempted to but no idea what is up with jcheck which blocks me.

> Pull request body is missing required line: - [x] I confirm that I make this 
> contribution in accordance with the [OpenJDK Interim AI 
> Policy](https://openjdk.org/legal/ai).


yet

<img width="1126" height="199" alt="image" 
src="https://github.com/user-attachments/assets/56b81946-c79a-4a2f-8da7-539f8a606200";
 />

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

PR Comment: https://git.openjdk.org/jdk/pull/30074#issuecomment-4287515842

Reply via email to