All Getting started guides have JDBC 2.0 specific sections

Hi all,

Something is confusing me here. The homepage for JDBC on java.sun.com is at http://java.sun.com/javase/technologies/database/index.jsp and there are a few links depending upon the version of SE one is using. The confusing thing here is that all three versions that i looked at have similar set of pages. Please have a look at:

http://java.sun.com/j2se/1.3/docs/guide/jdbc/getstart/GettingStartedTOC.fm.html

http://java.sun.com/j2se/1.4.2/docs/guide/jdbc/getstart/GettingStartedTOC.fm.html

http://java.sun.com/j2se/1.5.0/docs/guide/jdbc/getstart/GettingStartedTOC.fm.html

http://java.sun.com/javase/6/docs/technotes/guides/jdbc/getstart/GettingStartedTOC.fm.html

and it is easily observeable that the first section (1-Introduction is same in all of the above). I chekced the docs directory of my local installation (Java SE 5.0) and i downloaded the docs for Mustang (Java SE 6) and there too the introduction chapter was same (discussin JDBC 2.0).

Whats wrong here? JDBC 3.0 is around for years now and should be part of SE 5. Also, i read somewhere that Mustang will ship JDBC 4.0. Is it that docs are not updated or am i missing something here?

Thanks for your time.

regards,

mnsharif

[1261 byte] By [mnsharifa] at [2007-11-26 22:15:25]
# 1
Why do you expect them to be dramatically different? The core features have remained the same throughout. Certainly the novice stuff that I'd expect to be addressed in a getting started guide has barely changed.
dcmintera at 2007-7-10 11:07:44 > top of Java-index,Database Connectivity,Java Database Connectivity (JDBC)...
# 2

Well, when the TOC says something like this...

1.1 What the JDBC 3.0 API Includes

1.2 What Is the JDBC API?

...

...

and when you click on the link 1.1, and the page that loads has the heading 1.1 What the JDBC 2.0 API Includes then this is certainly something which rings bells

btw, chapter numbers are also off-by-1 after chapter 5.

mnsharifa at 2007-7-10 11:07:44 > top of Java-index,Database Connectivity,Java Database Connectivity (JDBC)...
# 3
Amazingly enough they started with the JDBC 2 document when creating the JDBC 3 document. So there are some typos in it.File a bug report or use the feedback link on that page.
dcmintera at 2007-7-10 11:07:44 > top of Java-index,Database Connectivity,Java Database Connectivity (JDBC)...
# 4
yeah, i just did.can't beleive looking at such a thing given the size of java community and the open source hype and everything
mnsharifa at 2007-7-10 11:07:44 > top of Java-index,Database Connectivity,Java Database Connectivity (JDBC)...
# 5

> can't beleive looking at such a thing given the size

> of java community and the open source hype and

> everything

Huh? What does the size of the Java community have to do with this? Only a tiny minority will be learning JDBC for the first time and thus require the getting started guide. Of those who do, how many will notice the typo? Of those that do, how many will report it (or indeed care)?

And what does any of that have to do with the "open source hype"? It's not like open source projects are notoriously well documented!

D.

dcmintera at 2007-7-10 11:07:44 > top of Java-index,Database Connectivity,Java Database Connectivity (JDBC)...