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 > > - [x] I confirm that I make this contribution in accordance with the [OpenJDK > Interim AI Policy](https://openjdk.org/legal/ai). This pull request has now been integrated. Changeset: 97ccabb2 Author: James Nord <[email protected]> Committer: Volkan Yazici <[email protected]> URL: https://git.openjdk.org/jdk/commit/97ccabb28e7ae81765a84b98ad418e0b7b87a505 Stats: 45 lines in 1 file changed: 0 ins; 4 del; 41 mod 8379567: URL documentation about encoding/decoding is hard to read Reviewed-by: vyazici ------------- PR: https://git.openjdk.org/jdk/pull/30074
