WCF Documentation Is Here
Chris
If you’ve been working with Windows Communication Foundation for a while, like I have, through all the Beta versions, you may have found it difficult to deal with the changes each time a new version is released. The documentation has been scant at best, and often I’ve found myself digging through blog posts to find proper documentation; tracking down changes to XML config names, for instance, can be a chore. Blogs are great resources for ideas and opinions, but they make poor documentation, mostly because people post in small chunks, rarely creating the lengthy entries necessary to properly document something.
Today I installed the latest June CTP of WinFX, now being called .NET 3.0. I wanted to play around with XAML and WPF and get the latest code for Windows Workflow Foundation as well. The side effect of this was new code for WCF. When I went to build the latest version of my application I worked through the compiler errors easy enough - just needed to reference the libraries. But XML doesn’t throw compiler errors, and when I fired up the app I got a few exceptions. The exceptions pinpoint what’s wrong of course, telling me that ‘type’ is now an unrecognized attribute, as is ‘maxMessageSize’, but unfortunatley they can’t tell you what you should do to replace them.
And then I discovered there is new documentation
You can get the new documentation here. It’s great stuff; some of the best documentation I’ve seen for a CTP. There’s several help files. Some of it is the usual stuff, class breakdowns, members, etc., but the cool thing is there’s now a complete listing of every XML attribute as well, with a description of what it is for and how to use it. And the documentation navigation is nested precisely like the XML attributes themselves, so it’s super easy to navigate and discover what a given attribute can & will do. There’s also documentation of explicit samples using WCF. That’s something I didn’t expect, but it rocks.
If you’ve been hesitant to jump into WCF because of lack of documentation then this release is the perfect time to get involved.
Posted in .NET |
No Comments »