Tony’s Oracle Tips

August 26, 2008

The new campaign – Oracle Documentation Improvement

Filed under: Uncategorized — tonyhasler @ 10:07 pm

Ok, Its time to take some action. The state of the documentation has been changing over the last few releases. On the one hand the outward appearance of the doc. set has improved. On the other hand the content seems to have deteriorated.

As I often do I will go off on a tangent before I have even started. Actually, the 11g documentation seems to have serious problems with IE7. Apart from the need to configure IE to allow active content, there seem to be cases where hyperlinks send you to the top of the page (instead of the relevant part) and also cases where CTR-F searches cause IE to hang.

However, the biggest issue is with the content, rather than the presentation of the documentation. In fact, the biggest whoppa that I have discovered to date is the javadoc for the JDBC API. This entire document seems to have been omitted entirely from the doc. set. It is available on OTN at:

http://www.oracle.com/technology/docs/tech/java/sqlj_jdbc/doc_library/javadoc/packages.html

However, there isn’t even a reference to it that I can find in the docset.

Anyway, to give credit where credit is due I have once sent feedback to Oracle to correct an error and on that occasion the error was swiftly corrected.  The error related to the 10.2 feature that allowed you to drop a datafile.  The documentation stated that you couldn’t drop the last file.  It should have said the first file.

I am trying again.  Before embarking on the JDBC Developer’s Guide and Reference (which has tons of issues) I am trying out the Data Warehousing Guide.  Chapter 22 covers the MODEL clause in SQL and there is a mortgage amortisation example that doesn’t work.  I have told them what the correction is.  Let us see what happens.

In the meantime, if you know of a problem please:

a) Check the 11g documentation and make sure it hasn’t already been corrected

b) let them know by e-mailing infodev_us@oracle.com.

c) Post a reply here.  I am keen to understand the scale of the problem.

Advertisements

Leave a Comment »

No comments yet.

RSS feed for comments on this post. TrackBack URI

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

Create a free website or blog at WordPress.com.

%d bloggers like this: