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 > > James Nord has updated the pull request incrementally with one additional > commit since the last revision: > > 8381184: remove whitespace from snippets @jtnord, thanks so much for the contribution and your patience. Using 13222215d08, verified that `make docs` succeeds, and the produced HTML page matches the visually expected output. ------------- Marked as reviewed by vyazici (Reviewer). PR Review: https://git.openjdk.org/jdk/pull/30074#pullrequestreview-4106639257
