• bvs23bkv33 (unregistered)

    read real oracle description about error SQL-02132

  • (nodebb)

    If the documentation were simple and accurate, how would Augur justify those monster consulting fees?

  • Pjrz (unregistered) in reply to bvs23bkv33

    Ah, the old "sdfla asdjklfajs jfja ajsdf" runtime context

  • Little Bobby Tables (unregistered)

    I was posted to a customer site some few thousand miles away (in the depths of winter for a few months, some way north of the 49th Parallel, brrr) who wanted to use some of the more abstruse and, er, "experimental" aspects of our application, because they wanted to reimplement much of our own functionality their way (NIP meets Inner Platform Effect via Complicit Project Manager, basically).

    So we (in my view mistakenly) exposed a layer of our IDE we rarely do. And of course the customer required the javadocs. Okay, said the team back home, we'll provide them the javadocs. Some weeks later, we got the package. Let me just take a quick look first, I decided, before I unleash them onto the customer.

    Good job I did, because most of the javadocs were along the line: "Oops! We really need to write the javadocs for this class! Don't hold your breath, though!"

    This and several other embarrassments borne of poor project management, customer obstinacy to change direction when it was clear they weren't getting anywhere, and a horrific approach to Agile, saw us stumbling away from the wreckage with a less than stellar repulation.

  • Little Bobby Tables (unregistered) in reply to Little Bobby Tables

    Sorry, for NIP in the above read NIH.

  • Whocares? (unregistered)

    A worthy classic.

  • RLB (unregistered)

    "May day" is indeed the correct context for such systems. (Sorry, Remy...)

  • my name is missing (unregistered)

    Augur is how you spell Oracle in WTF.

  • Supersonic Tumbleweed (unregistered)

    Comment held for until you buy my consulting

  • Ex-lurker (unregistered)

    Remy just forgot to include among the bad documentation examples the blatantly useless docs.

    The documentation of a tool I have the displeasure of working with is composed almost entirely of statements like "Button 'Taskbar': Click this button to set the properties of the taskbar." Wow, what a twist! All this time I was thinking it would be used to drop a random database, connect to a webservice, generate an updated network map, revert changes on a DFD schema, initiate a FTP transfer, dump a screenshot of the internet and flip Skynet's settings from "Debug mode" to "Production". Thankfully we cleared that up. Would never have guessed it if it wasn't for the documentation.

  • Ex-lurker (unregistered)

    SNAPSHOT of the Internet, dammit. Tho I'm imagining now what a screenshot of the internet would look like and what kind of technology would be needed for it to happen.

  • Duke of New York (unregistered)

    This would have worked even better in Zork transcript format, with occasional references to Frobozzco

  • fintech guy (unregistered)

    Sounds like my previous experience with somtehing called Endur which among other things measured gas in pipes... but it is clearly a coincidence. ;)

  • (nodebb) in reply to Ex-lurker

    All this time I was thinking it would be used to drop a random database, connect to a webservice, generate an updated network map, revert changes on a DFD schema, initiate a FTP transfer, dump a screenshot of the internet and flip Skynet's settings from "Debug mode" to "Production".

    If it is an "Augur" system and you've not set the magic flag somewhere deeply non-obvious, pressing that button might do exactly that!

  • doubting_poster (unregistered)

    The real WTF is all the typos.

  • I Am A Robot (unregistered)

    Currently struggling through an upgrade and asked the vendor for release notes showing the differences. We received a silent video of someone clicking options in a menu without any other description.

  • Former Lurker (unregistered)

    Step one: complain about docs that use in-house terms without defining them. Step two: shoot yourself in the foot by wheeling out a litany of initialisms without definitions. Step three: publish it on a site full of cynical, jaded pedants.

    What could possibly go wrong?

Leave a comment on “You'd Need an Oracle to Understand These Docs”

Log In or post as a guest

Replying to comment #497988:

« Return to Article