Hello!
I am currently working on a book that will target Silverlight 1.1, called "Silverlight 1.1 in Action" and I am seeking some feedback from the community. The first half of the book will address the UI elements of Silverlight, while the second half will discuss the .NET Framework provided with Silverlight 1.1.
Because the first half of the book is squarely focussed on UI components, I thought it would be nice to add some additional value to the book by explaining how to create the various UI components using
Microsoft Expression Blend. The incorporation of Blend has caused some internal debate between me and myself. However, I feel that incorporating Blend is important because it may introduce readers to a new, productive tool, while at the same time, helping readers build a vocabularly that can help to communicate with designers more effectively. Essentially, for each UI element, I want to provide the following:
- An illustration that shows the UI element that is created
- The XAML that corresponds with the illustration
- A walkthrough of how to use Blend to create the UI element.
My debate is as follows:
Option 1 - Provide all three items (the illustration, the XAML, and the walkthrough) for each UI component. Here are the advantages/disadvantages I see with this approach:
- Advantages
- Readers do not have to flip to the back of the book for Blend content.
- Encourages the use of Blend while reading the text
- Disadvantages
- Takes up a lot of space. This may cause the reader to skip pages to get back into the developer focussed content.
Here is a sample of creating a MediaElement to give you a feel for how this
may look in the text if Option 1 is used.
Option 2 - Provide only the illustration and the XAML in the text. Then, reference a walkthrough which is provided in an appendix, instead of in the actual text. Here are the advantages/disadvantages I see with this approach:
- Advantages
- Keeps the reader focussed on the developer related content.
- Disadvantages
- Treats Blend as a second-rate citizen (it's not, it is especially helpful if you are creating animations)
- Causes the reader to flip between the actual text and an appendix, this searching can be annoying.
Here is a sample of creating a MediaElement to give you a feel for how this
may look in the text if Option 2 is used:
Personally, I am leaning towards Option
2, however, I wanted to seek some feedback before going too far down this path. I look forward to your comments and thank you for your help!