• cfradenburg (6/26/2012)


    GSquared (6/26/2012)


    Imagine if you bought a toolkit from, for example, Sears, and it had some tools in it that you had never seen before. So you ask them what the tools are and how to use them, and the answer given is, "those are undocumented by design". The reaction? ... Yeah.

    I think a better comparison are appliances where you start opening it and see something that says, "No user serviceable parts inside." You should be able to do pretty much anything you need to without cracking into that. However, there are going to be times that someone with extra training is needed to fix the appliance.

    The more that's documented the more that we can reliably do ourselves so I am in favor of documentation. However, I understand the hesitation to put all the time into documenting DBCC page when they could be working on new features that are going to be used more frequently.

    There's a big difference between telling a user "don't try to service your TV yourself, there are parts in there that can kill you, and you don't know which ones they are", and telling professional DBAs, "we can't be bothered to tell you how that works".

    You know the TV ads and such that have the warning on them, "Professional driver on closed course"? Well, we are the professional drivers. And the pro mechanic team. And many of us are highly trained engineers on the exact subject at hand.

    So I don't see it as comparable to "no user servicable parts".

    - Gus "GSquared", RSVP, OODA, MAP, NMVP, FAQ, SAT, SQL, DNA, RNA, UOI, IOU, AM, PM, AD, BC, BCE, USA, UN, CF, ROFL, LOL, ETC
    Property of The Thread

    "Nobody knows the age of the human race, but everyone agrees it's old enough to know better." - Anon