Microsoft Documentation Declared Unfit For US Consumption
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."
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.
IANAL, because I have two more semesters of law school to complete. Before that, I was a computer science major.
Your mistake is that you are comparing legal code to software documentation. However, the more apt comparison is to compare legal code to software source code, at which point your analogy fails. While they aren't widely advertised, there are plenty of secondary sources (such as legal encyclopedias) out there that make law accessible to a layman.
I'm a lawyer, but not yours. I wouldn't represent someone who thinks taking legal advice from Slashdot is a good idea.