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: Lew on 10 Jul 2010 13:13 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. Do you have *any* shred of evidence that that's the purpose? >> 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 Mike Schilling wrote: > 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. For months now, Oracle has warned us: "Oracle is reviewing the Sun product roadmap and will provide guidance to customers in accordance with Oracle's standard product communication policies. Any resulting features and timing of release of such features as determined by Oracle's review of roadmaps, are at the sole discretion of Oracle. All product roadmap information, whether communicated by Sun Microsystems or by Oracle, does not represent a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. It is intended for information purposes only, and may not be incorporated into any contract." So what, we expected that meant Oracle was not going to rearrange the web site in accordance with their standard product communication policies? As for finding the serialization specification, you don't even need Google. The third hit on the "search.sun.com" site itself, entering "serialization specification" in the search box on http://java.sun.com/ itself, is <http://java.sun.com/j2se/1.5.0/docs/guide/serialization/spec/serialTOC.html> which, guess what? redirects to <http://download.oracle.com/docs/cd/E17476_01/javase/1.5.0/docs/guide/serialization/spec/serialTOC.html> Yeah, Oracle's trying reeeaaaal hard to hide the information when the old link leads you right to the new one. Just for shites and giggles I entered "tutorial regex" in the search box on java.sun.com. The first hit is <http://java.sun.com/docs/books/tutorial/essential/regex/> which redirects to <http://download.oracle.com/docs/cd/E17409_01/javase/tutorial/essential/regex/> Likewise, <http://java.sun.com/docs/books/tutorial/essential/regex/quant.html> (the very first link in a java.sun.com search for "tutorial regex quantifiers" and the natural extension of the above link) redirects to <http://download.oracle.com/docs/cd/E17409_01/javase/tutorial/essential/regex/quant.html> Hmm, that's the very link Roedy claims to be "strange" and "hard to find". It's also the one from the "Quantifiers" anchor tag in the main regex tutorial page. Looks like <http://java.sun.com/docs/books/tutorial/extra/regex/quant.html> was an incorrect URL in the first place. Chalk that one up to operator error rather than evil Oracle's nefarious misdeeds. -- Lew
From: Arne Vajhøj on 10 Jul 2010 16:48 On 10-07-2010 13:13, Lew wrote: > 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. > > Do you have *any* shred of evidence that that's the purpose? I think that is what is generally known as a conspiracy theory. And those does not come with evidence. And typical the people that bring them up are not even looking for evidence. Arne
From: Arne Vajhøj on 10 Jul 2010 16:52 On 10-07-2010 11:54, 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 > > 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. Keeping URL's is good. But in case of a merger like this, then a change is almost unavoidable. One of the things Oracle paid all that money for is for the Java name. They want something for that money. > >> 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. It is not practical to have the CMS internally use the old URL's. Of course they could rewrite all URL's from old to new. But apparantly they decided not to bother with that. Arne
From: Roedy Green on 10 Jul 2010 21:04 On Sat, 10 Jul 2010 13:13:58 -0400, Lew <noone(a)lewscanon.com> wrote, quoted or indirectly quoted someone who said : >>> Oracle has been pulling documentation off the Sun website and giving >>> it strange new URLs to make it hard to find the new docs. > >Do you have *any* shred of evidence that that's the purpose? Ok, "Oracle has been pulling documentation off the Sun website and giving it strange new URLs THAT make it hard to find the new docs." I was just teasing Oracle, giving them benefit of the doubt their incompetence had some purpose to it. Each nation has its own humour templates. This is a pretty common idiom in Canada. Use of the smiley is not. The whole point is to slip the humour in slyly so that only a few catch it. Then those that get it feel pleasure at their cleverness. It is supposed to be almost undetectable to everyone else. -- 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: Arne Vajhøj on 10 Jul 2010 21:50
On 10-07-2010 21:04, Roedy Green wrote: > On Sat, 10 Jul 2010 13:13:58 -0400, Lew<noone(a)lewscanon.com> wrote, > quoted or indirectly quoted someone who said : > >>>> Oracle has been pulling documentation off the Sun website and giving >>>> it strange new URLs to make it hard to find the new docs. >> >> Do you have *any* shred of evidence that that's the purpose? > > Ok, "Oracle has been pulling documentation off the Sun website and > giving it strange new URLs THAT make it hard to find the new docs." > > I was just teasing Oracle, giving them benefit of the doubt their > incompetence had some purpose to it. Each nation has its own humour > templates. This is a pretty common idiom in Canada. Use of the smiley > is not. The whole point is to slip the humour in slyly so that only a > few catch it. Then those that get it feel pleasure at their > cleverness. It is supposed to be almost undetectable to everyone > else. Do they have training classes in Canada on "How to communicate on the internet with people from different cultures by not assuming everybody is exactly like people in Smallville Canada" ? :-) Arne |