Velocity Reviews - Computer Hardware Reviews

Velocity Reviews > Newsgroups > Programming > Java > Documentation hiding

Reply
Thread Tools

Documentation hiding

 
 
Roedy Green
Guest
Posts: n/a
 
      07-10-2010
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/tutor...gex/quant.html
// now:
http://download.oracle.com/docs/cd/E...gex/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.
 
Reply With Quote
 
 
 
 
Arved Sandstrom
Guest
Posts: n/a
 
      07-10-2010
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/tutor...gex/quant.html
> // now:
> http://download.oracle.com/docs/cd/E...gex/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
 
Reply With Quote
 
 
 
 
Arne Vajhøj
Guest
Posts: n/a
 
      07-10-2010
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/tutor...gex/quant.html
> // now:
> http://download.oracle.com/docs/cd/E...gex/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


 
Reply With Quote
 
Stefan Ram
Guest
Posts: n/a
 
      07-10-2010
Arne Vajhøj <> 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.

>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.

 
Reply With Quote
 
Jeff Higgins
Guest
Posts: n/a
 
      07-10-2010
On 7/10/2010 11:54 AM, Stefan Ram wrote:
> Arne Vajhøj<> 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.
>


 
Reply With Quote
 
Mike Schilling
Guest
Posts: n/a
 
      07-10-2010


"Roedy Green" <> wrote in message
news:...
> 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/tutor...gex/quant.html
> // now:
> http://download.oracle.com/docs/cd/E...gex/quant.html


The Java serialization specification, for instance, is now hidden at
http://download.oracle.com/docs/cd/E...serialTOC.html .
I was able to find it only by using the obscure technique of googling for
Java serialization specification.

 
Reply With Quote
 
Lew
Guest
Posts: n/a
 
      07-10-2010
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/tutor...gex/quant.html
>> // now:
>> http://download.oracle.com/docs/cd/E...gex/quant.html


Mike Schilling wrote:
> The Java serialization specification, for instance, is now hidden at
> http://download.oracle.com/docs/cd/E...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
 
Reply With Quote
 
Arne Vajhøj
Guest
Posts: n/a
 
      07-10-2010
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
 
Reply With Quote
 
Arne Vajhøj
Guest
Posts: n/a
 
      07-10-2010
On 10-07-2010 11:54, Stefan Ram wrote:
> Arne Vajhøj<> 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

 
Reply With Quote
 
Roedy Green
Guest
Posts: n/a
 
      07-11-2010
On Sat, 10 Jul 2010 13:13:58 -0400, Lew <> 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.
 
Reply With Quote
 
 
 
Reply

Thread Tools

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Trackbacks are On
Pingbacks are On
Refbacks are Off


Similar Threads
Thread Thread Starter Forum Replies Last Post
Script for Hiding/Un-Hiding Text On Click Ste Javascript 41 08-01-2007 02:35 PM
converting XSD documentation to HTML documentation kev.sully@gmail.com XML 1 09-16-2006 12:09 PM
Firefox 1.0 open but hiding Liora Firefox 5 10-12-2005 04:23 AM
Python documentation: How about structured documentation? Looking for comments/suggestions Kenneth McDonald Python 2 05-06-2004 04:11 AM
Principles of documentation (was: Python Documentation Blows!) Cameron Laird Python 1 04-03-2004 06:54 PM



Advertisments
 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57