Sunday, August 27, 2006

Documentation

I like Microsoft's SDK documentation.

Partially, anyway. I don't like the fact that the navigation doesn't work properly on msdn.microsoft.com/library unless you're using Internet Explorer. And often it's difficult to find which section they've hidden something in this week. And often the documentation is just plain wrong. But I do like being able to have everything in one place. And I like that there are overviews, tutorials and examples alongside the technical reference. So you don't just know what classes and methods are available, you also know how to use them. And I know it's not fashionable to like documentation to look nice when you're a linux developer, but I do find that if class documentation is layed out nicely, it makes it so much easier to find what I'm looking for.

I don't know where I'm going with this. But while I'm blogging about stuff, I thought I'd blog this too.

1 comment:

Peter Brett said...

I think the way the GLib/GObject/GTK+ documentation is presented is quite nice.