[Mono-list] MS doc discrepencies
Miguel de Icaza
miguel@ximian.com
27 Feb 2002 12:24:03 -0500
> I've been working on MonoTests.System.MathTest, running it with the
> Microsoft runtime, and testing the Microsoft classes. What I found is that
> in a couple of cases the Microsoft System.Math class does not behave as the
> documentation describes it.
>
> This makes me wonder which I should treat as law. Should I write the tests
> to they follow the docs to the letter, or should I write them so they all
> pass when run against the Microsoft classes?
Documentation might also contain bugs, so my suggestion is that:
* You write down the problem, so we can forward this to the
Microsoft people to track the problem down.
* Try to get the test to run with the Microsoft runtime, most
likely the bug is in the documentation (we have already ran
into a couple of those, they will be updating their
documentation with the bug fixes in the future).
* If you gut instinct is that the documentation is right, and
the implementation wrong, then do the opposite.
But I encourage you to always document the problem, so we can follow up
with them.
> It's also possible I'm doing something wrong. I'll send my code to whoever
> wants to proof it, but I don't want to clutter the mailing list just yet
> ^_^.
Post it to the list, we will be happy to help ;-)
We will take it from there.
> Also, assuming this all gets worked out, should I simply post the code to
> this list?
Yes, that would be excellent! Or we could give you a CVS account once you are ready.
Miguel.