Silence...

Where have I been?

Sadly, nowhere good.

My father passed away extremely unexpectedly on March 4, 2008 and life has been hectic and chaotic ever since.  I'm finally back into some sort of routine, so it's time to update here and explain what's going on outside of the unpleasantness.

First off, I've been contracted to co-author a book for O'Reilly (tentatively) titled Coding4Fun with Dan Fernandez from Microsoft.  The book will be a compendium of 10 (give or take) projects that, as the title suggests, combine fun and coding.  I'll update as we go through the process.

Secondly, I'll be presenting a session titled Introduction to Microsoft Robotics Studio with Lego NXT at the Tech Valley Code Camp this Saturday, April 19th.  If you're in the area, as always, stop by.  It should be a fun and informative day.

And finally, I will be back to work on some Wiimote goodness soon.  I was right in the middle of Guitar Hero controller support when the above …

Read More

Sandcastle and API Documentation

I’ve received a few emails recently on how I created the API documentation for my Wiimote library so I thought I’d answer here with a brief tutorial.

The answer, in case you didn’t read the post subject, is Sandcastle. Sandcastle is a tool developed by Microsoft which builds MSDN-style help files by using reflection and XML comments from the source code of a project. Out of the box, Sandcastle is command line driven and kind of a pain to deal with, so I highly recommend the very easy to use Sandcastle Help File Builder (SHFB) application also hosted on CodePlex. This front-end provides a simple UI for setting options and building your help file in just a few minutes. The rest of this post assumed you have both Sandcastle and Sancastle Help File Builder installed.

Building documentation is easy. First, add XML documentation comments directly to your source code. You can do this by typing 3 forward slashes in Visual Studio above your …

Read More