Slashdot Mirror

← Back to Stories (view on slashdot.org)

Microsoft Documentation Declared Unfit For US Consumption

Posted by ryuzaki0 on from the time-to-see-the-self-documenting-code dept.

anomalous cohort writes "Washington DC judge Colleen Kollar-Kotelly announced during the ongoing Microsoft antitrust hearings that their documentation is unfit for US consumption. This is relevant in an antitrust hearing as poor documentation on how to inter-operate with Microsoft's products is seen as an unfair barrier to entry for companies who compete with Microsoft. Others see this as yet another example of their crumbling hegemony or indolence as their empire burns."

20 of 243 comments (clear)

  1. This is good. by WK2 · · Score: 4, Funny

    Acknowledgment is the first step to recovery.

    --
    Write your own Choose Your Own Adventure. http://www.freegameengines.org/gamebook-engine/
    1. Re:This is good. by alexborges · · Score: 4, Informative

      Get a grip, hippo, they dont mean your kb.ms thingie. They mean the INTEROPERABILITY docs, which you will NEVER see in a website such as your msdn.

      --
      NO SIG
  2. Fair and balanced by Ethanol-fueled · · Score: 5, Funny
    From TFS:

    "...Others see this as yet another example of their crumbling hegemony or indolence as their empire burns."

    In this day and age of increasingly biased reporting, it is nice to see that Slashdot continues to present an objective, fair, and balanced approach to covering the issues.

    Scuttlemonkey could work wonders for the Middle-East peace process!

    1. Re:Fair and balanced by SoCalChris · · Score: 5, Insightful

      Slashdot has always been biased towards Linux. As far as I know, they've never even pretended to be a fair and balanced source of IT news. Have you noticed the borg icon that's used for MS stories?

    2. Re:Fair and balanced by KillerBob · · Score: 5, Insightful

      Slashdot is about as unbiased and balanced as Fox News.

      Microsoft has been responsible for some really enormous fuckups and wrongs in the world of computers. They have some utterly nasty business practices that really are anti-competitive. They did, at one point, have a virtual monopoly, though that is crumbling naturally due to market forces, as more and more people in the market discover just how shitty Vista is, and how good Linux and OS/X are in comparison. That's only part of their monopoly (the other part being their office products, and that will come in time).

      The thing being... for all their evils and wrongs, there's been a few good things that have come from them. And while I freely admit to being an idealist, I do like to think that the evil profit-mongering is limited to the upper echelons of the company only, and that at the lower ranks, you find people who really are trying to make the best product they can for computer users.

      --
      If you believe everything you read, you'd better not read. - Japanese proverb
    3. Re:Fair and balanced by SL+Baur · · Score: 5, Insightful

      Or maybe, just maybe, Slashdot is fair and balanced, and Microsoft really is a nest of black-hearted villains.

      "Fair and balanced" is probably never going to mean the same thing to two different people, especially your husband/wife/SO/etc.

      I am not a big fan of Microsoft, all of their products had crippling bugs or limitations in them when I first started exploring there (Applesoft BASIC, PC DOS 2.0, etc.). I took a look at Microsoft Windows and OS/2 when they were first released and was unimpressed.

      However, I have been impressed with Unix and its descendents since I first encountered them in college. The big Blue and Green books documenting Version 7 Unix were useful for everything Unixy at the time and I've always like the multiuser/multiprocessing aspect of the system. System V/R2 was a disaster on the order of Microsoft Windows XP (so I've read, I only used Microsoft Windows XP/SP2 for about half a year and it was only less stable than System V/R2 with patches), but it was released two decades earlier and since has all the problems worked out.

      The Unix model, as first designed by Ken Thompson and Dennis Richie has withstood the test of time as no other software project ever has. They killed the proprietary O/S model on minis and mainframes. They killed the idea of non-portable OSes, though Microsoft has resurrected that idea. They so excited the minds and hearts of programmers that dozens of reimplemented spinoffs were done ... and survive to this day.

      On the other hand, Billg spent more on his two recent TV ads for an O/S that few want to buy than Thompson and Richie made in their lifetimes. Sigh.

  3. It's a step... by spazdor · · Score: 4, Funny

    Documentation unfit. Awesome.

    Now what about the software?

    --
    DRM: Terminator crops for your mind!
  4. Man... by scubamage · · Score: 4, Funny

    When will this unjustified persecution of undocumenting coders be stopped!? If I can understand 15 layers of recursion with pointers to 8 dimensional arrays and no documentation, you should be able to as well!

  5. All code is self-documenting... by ivandavidoff · · Score: 5, Funny

    For coders, at least. Documentation is for auditors.

    1. Re:All code is self-documenting... by El_Muerte_TDS · · Score: 4, Insightful

      For coders, at least.

      If that would only be true. Documentation usually lists _intended_ behavior, not actual behavior. When code is self-documenting it is documenting the actual behavior, or at least, partially.

  6. Sure by tsotha · · Score: 5, Insightful

    Others see this as yet another example of their crumbling hegemony or indolence as their empire burns."

    And still others realize their documentation is probably no crappier than anyone else's.

    1. Re:Sure by 91degrees · · Score: 5, Insightful

      True. Only the other day I was bitching about the crappy documentation on a piece of code, and I was the one who wrote it!

      Programmers are always completely oblivious as to what will not be so obvious to someone else or themselves several months down the line. At the time you;re writing it, it's quite clear that the routine will do exactly what you want it to do at that moment.

  7. Bad summary by fiannaFailMan · · Score: 4, Informative

    Those linked blogs say nothing about "yet another example of [Microsoft's] crumbling hegemony or indolence as their empire burns."

    --
    Drill baby drill - on Mars
  8. Irony by haystor · · Score: 5, Insightful

    There is a certain irony that the legal system decides someone else has poor documentation. The documentation of the law requires a graduate degree to use.

    I'm no fan of Microsoft, but their documentation is ironclad compared to the law. Witness this case, it is only after the fact that it becomes vaguely clear that having poor documentation is wrong (even for a monopoly).

    --
    t
  9. In the land of the blind... by djpretzel · · Score: 4, Insightful

    Scary thing is, I've always found their doc decent... relative to other companies. This judge needs to attempt to assemble some of the more ornate IKEA offerings - she'll have a new appreciation for MSDN/Technet...

    1. Re:In the land of the blind... by slittle · · Score: 5, Insightful

      As the article says, Microsoft documents the things they want you to know very well (more software for Windows == good), so it's not like they have a corporate culture of crap documentation. What they don't do is document things they don't want you to know, like formats and protocols, because that would allow you to use non-Microsoft software somewhere (== bad).

      Since their documentation is obviously biased, they're in trouble again.

      --
      Opportunity knocks. Karma hunts you down.
  10. Contempt Charges? by camperdave · · Score: 4, Insightful

    But Judge Colleen Kollar-Kotelly, who is overseeing the consent decree, ruled that Microsoft still hadn't sufficiently documented some protocols, despite those documents having been due in 2003.

    Five years to produce a document? Is it normal to allow a company such lattitude in the courts? If a rank and file citizen were to take that long, I think they'd have been slapped with a contempt of court charge, or they would have been ruled against, long ago. Why the leniency?

    --
    When our name is on the back of your car, we're behind you all the way!
  11. Seriously? by HerculesMO · · Score: 5, Funny

    I've read lots of MS Documentation over the years -- white papers, APIs, and just general guidelines for things.

    It's damned good documentation. It may not go to the border of 'special olympics' readers for Apple users, but for the majority of developers that are working on 'interoperability' the documentation is quite good. Not amazing, but the irony is still lost on me that a lawyer decided somebody else's documentation was bad.

    Have you ever read the way bills are introduced into law? Jeez.

    --
    The price is always right if someone else is paying.
  12. she had/has no clue who she is up against by Locutus · · Score: 4, Insightful

    The Microsoft people are making fools of her and the court system and she hardly even knows it. If she did, she'd have ripped them a new hole long ago and imposed sanctions on them instead of letting this drag out year after year.

    Isn't it getting to the point of irrelevant in this year of late 2008? After all, interoperability is more of a threat to their business than any court Justice and they know this and spend billions annually protecting that. IMO.

    LoB

    --
    "Anyone who stands out in the middle of a road looks like roadkill to me." --Linus
  13. Slashvertisement by level4 · · Score: 4, Interesting

    Article submitter:

    anomalous cohort (http://www.dynamicalsoftware.com/)

    From the marketing "blog" linked in the summary (http://www.dynamicalsoftware.com/cgi-bin/ViewBlogEntry.pl?id=14)

    writing and maintaining developer documentation is an important part of any software development project [...] Another reason for documentation is compliance management [...] our collaborative software development project lifecycle management product Code Roller supports compliance management [...]

    Nice try!

    --
    Let my new 7-digit UID be a lesson to all - write down your passwords.