Oracle FAQ Your Portal to the Oracle Knowledge Grid
HOME | ASK QUESTION | ADD INFO | SEARCH | E-MAIL US
 

Home -> Community -> Usenet -> c.d.o.misc -> Is Oracle the worst-documented product of all time?

Is Oracle the worst-documented product of all time?

From: Richard Burton <rburton_at_rohms.com.NOJUNKMAIL!>
Date: 1997/07/07
Message-ID: <33c17027.4336285@news.icorp.net>

A "Newbie's" view of Oracle

I'm about a month into Oracle, and I feel somewhat obligated to document some of my frustrations and opinions on various issues. I have no intention of slamming the company or its products, but at the same time, I can't help but be appalled at how unnecessarily difficult it is to go from zero-to-twenty. I want to make note of these things for several reasons:

  1. I don't want to forget how much a pain this process has been, and don't want to turn into another 'DBA clone', who, once he's gone through the trial by fire of learning Oracle, maintains that it's child's play, and starts accepting what I consider to be unacceptable quality control as status quo.
  2. My sincere hope is that some of these criticisms are taken to heart by the appropriate people; by expressing my opinions in a public forum, I feel I have a better chance of attaining this goal (as well as give others the opportunity to debate the issue).

Suffice to say, everything in this message is MY OPINION. Take it with a grain of salt.

Let me preface this diatribe by saying where I'm coming from. I'm an accomplished programmer in various languages and platforms. My work has won numerous honors and awards, including "Editor's Choice" in PC Magazine. However, I'm a complete newbie (or at least I was a few months ago) at SQL and Oracle. I'm typically able to get up to speed on new systems very quickly. This was not the case with Oracle, and I'm well aware I've made a lot of brainless mistakes; incorrect assumptions, and have often been guilty of lacking patience & dilligence, however I don't believe I could possibly be near the low end (in terms of competence & attention span) of those who might be preparing to enter the Oracle world.

First and foremost, I have to admit that most of Oracle's products are very well designed. The performance and stability seems to be way above average, which IMO probably has the most to do with Oracle's success. However, on the other side, I'm appalled at how unnecessarily convoluted the support and education process is. I have yet to take any Oracle classes, but I don't feel that this should be a prerequisite to being able to be productive with the world's most popular database system. If I'm wrong, then I feel this is a weakness in the company's marketing strategy.

OTOH, I'm quickly starting to speculate that Oracle may end up making more money from support-related services than they do from selling products. If this is the case, then perhaps all of these faux pas are actually, carefully orchestrated in order to stimulate revenue. I can't say I'm very thrilled with this realization, but there are so many glaring ommissions and bad documentation, that it must be the case, and I think it's pretty sad.

Nonetheless, I'll share some examples of my gripes and solicit comments:

A classic example of Oracle's obvious inability to properly document their systems can be found in one of their most popular and recent publications, "Oracle, The Complete Reference" - how ironic!

The first half of the book moves like a tutorial and introduction to Oracle, unfortunately the logic of how information is presented leaves a LOT to be desired.

For example, I don't understand why the tutorial on creating tables is in Chapter SIXTEEN, following chapters such as, "Some Complex Possibilities", and "Advanced Use of Functions and Variables." You can be quite confident that all your possibilities will be complex when you haven't yet figured out how to create a table! Once again, I want to know what kinds of mushrooms the technical writers are putting on their pizzas!

The above is representative of most of this "reference." Information is incomplete and unorganized all over the place.

Oracle manages to take a rather easy language and cloak it in some of the worst documentation produced on the planet. This obviously explains why DBAs command such high salaries; who has the patience to dance through megabytes of online manuals, thousands of pages of printed books, hours of classes, and hours of tech support to build a simple database? One thing's for sure, DBAs obviously have an unparalleled level of tolerance and patience - a very noble quality.

In closing, I find it a shame that such good products are so darn difficult to learn when they don't need to be. It's true, once you get up to speed with Oracle, it becomes much easier - but there is no excuse for the horrible, horrible, horrible documentation!!!! Received on Mon Jul 07 1997 - 00:00:00 CDT

Original text of this message

HOME | ASK QUESTION | ADD INFO | SEARCH | E-MAIL US