>Since then, it is well known by average experienced Java developers to a) read javadocs, b) not use URL class, and c) use URI

P.S. not trying to flame here.

so im looking here https://docs.oracle.com/en/java/javase/17/docs/api/java.base... and I couldnt see any place where it is specifically recommended to NOT use java.net.url and instead use java.net.URI

thinking from the perspective of someone new to Java.

Also when i search for "java url class" on Google...i only see java.net.url