On Thu, 5 Mar 2026 11:14:10 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 @jtnord, even better, you can use `{@snippet : ... }` instead of `<pre>{@code ...}</pre>` I shared earlier. ------------- PR Comment: https://git.openjdk.org/jdk/pull/30074#issuecomment-4034228073
