| Glynn Timmins 2004-08-13, 5:51 pm |
| I can't help thinking that a hit 'n' miss approach is being used for
development of Biztalk Server 2004 Documentation. For instance, the
April version of the document entitled "Disassembling Result Sets
Using the SQL Adapter" has been replaced in the July 28th version I
have here. I tried the April version, and from what I can see, it got
into a twist over namespaces, and so was superceded. But it's
successor, the July version, really isn't much better. Here's what I
noticed (and I'm a Biztalk beginner, so others might have spotted
more)...
* It specifies that the Envelope property of the
CategoriesEnvelope.xsd schema should be set to "No".
* It doesn't instruct you to set the Body XPath property of the
CategoriesEnvelope.xsd schema.
* The author's left a reminder for himself/herself to paste some
illustrative code at the end of the document, but then forgotten to do
so.
OK, these are minor glitches and it's a great product on the whole,
BUT... for those wanting to learn the product, it makes the process a
lot slower and more tedious, because as a beginner, you're never quite
sure whether it's something YOU'VE done wrong, or a problem with the
instructions.
Please, for the sake of the product AND the people using it, could the
documentation be quality-tested before publication? You know, like the
software itself....
Thanks!
|