Documentation hiding
in [Java Help]
|
Prev: Generics: instantiating an object from a class name in configuration
Next: Generics: instantiating an object from a class name in configuration
From: Roedy Green on 10 Jul 2010 09:22 Oracle has been pulling documentation off the Sun website and giving it strange new URLs to make it hard to find the new docs. e.g. // used to be: http://java.sun.com/docs/books/tutorial/extra/regex/quant.html // now: http://download.oracle.com/docs/cd/E17409_01/javase/tutorial/essential/regex/quant.html The Guides seem to have disappeared. They used to be part of the JDK. -- Roedy Green Canadian Mind Products http://mindprod.com You encapsulate not just to save typing, but more importantly, to make it easy and safe to change the code later, since you then need change the logic in only one place. Without it, you might fail to change the logic in all the places it occurs.
From: Arved Sandstrom on 10 Jul 2010 10:26 Roedy Green wrote: > Oracle has been pulling documentation off the Sun website and giving > it strange new URLs to make it hard to find the new docs. > > e.g. > // used to be: > http://java.sun.com/docs/books/tutorial/extra/regex/quant.html > // now: > http://download.oracle.com/docs/cd/E17409_01/javase/tutorial/essential/regex/quant.html > > The Guides seem to have disappeared. They used to be part of the JDK. I don't think they're doing it on purpose. They've always had a fairly crappy website, so it's only fair that the Sun documentation also gets the treatment. AHS -- The warning message we sent the Russians was a calculated ambiguity that would be clearly understood. -- Alexander Haig
From: Arne Vajhøj on 10 Jul 2010 10:36 On 10-07-2010 09:22, Roedy Green wrote: > Oracle has been pulling documentation off the Sun website and giving > it strange new URLs to make it hard to find the new docs. > > e.g. > // used to be: > http://java.sun.com/docs/books/tutorial/extra/regex/quant.html > // now: > http://download.oracle.com/docs/cd/E17409_01/javase/tutorial/essential/regex/quant.html > > The Guides seem to have disappeared. They used to be part of the JDK. The URL's should not matter much. The reason behind the URL's are probably the use of some portal/CMS system. Obviously everything should be there, but I would expect it to eventually be there - but when moving huge web sites around, then a few things can be forgotten. I suggest you inform the web master about the problem. Arne
From: Jeff Higgins on 10 Jul 2010 12:12 On 7/10/2010 11:54 AM, Stefan Ram wrote: > Arne Vajh�j<arne(a)vajhoej.dk> writes: >> The URL's should not matter much. > > Yes, but: > > �Cool URIs Don't Change� > > http://www.w3.org/Provider/Style/uri Multiple Choices Now that is hilarious. > > Now, suddenly thousands of link collections are partially > invalidated and many hours are spend to update links all > around the world without any additional benefit. > >> The reason behind the URL's are probably the use of some >> portal/CMS system. > > That should not be an excuse. After all, the software should > follow and implement the policies chosen by humans. Humans > should not instead follow and implement what their software > requires. A capable engineer should be able to implement any > wanted URI naming scheme with a CMS. >
From: Mike Schilling on 10 Jul 2010 12:40
"Roedy Green" <see_website(a)mindprod.com.invalid> wrote in message news:2grg361pjgplv9jcj552tt9bptc2s469g2(a)4ax.com... > Oracle has been pulling documentation off the Sun website and giving > it strange new URLs to make it hard to find the new docs. > > e.g. > // used to be: > http://java.sun.com/docs/books/tutorial/extra/regex/quant.html > // now: > http://download.oracle.com/docs/cd/E17409_01/javase/tutorial/essential/regex/quant.html The Java serialization specification, for instance, is now hidden at http://download.oracle.com/docs/cd/E17476_01/javase/1.5.0/docs/guide/serialization/spec/serialTOC.html . I was able to find it only by using the obscure technique of googling for Java serialization specification. |