Software Engineering, Project Management, and Effectiveness
Developer Guidance Maps are treasure maps and guided tours of our developer content collections. They are consolidated and organized views of content collections spanning Channel9, MSDN Developer Centers, MSDN Library, Code Gallery, CodePlex, the All-in-One Code Framework, www.ASP.net, www.Silverlight.net, WindowsClient.net, etc. I’m creating these as part of our “IA” effort. One of the things I’ve been tasked with is creating an IA, or "information architecture," for the developer guidance ecosystem at Microsoft. As part of that effort, I have to map out what we already have as well as identify the various sources of content and clearing houses. Rather than simply do this behind the scenes, I’ve decided to share the maps with you as I go so that you benefit … thus Developer Guidance Maps were born.
Each map basically provides a map of the technology (common categories, features, scenarios), sources of where to look for key content, a Getting Started section of content, an Architecture and Design section of content, and then extensive content collections for Code Samples, How Tos, Videos, and Training, organized by scenarios and common tasks.
Benefits of Developer Guidance Maps
Developer Guidance Maps Available for Download Here is a roundup of the current Developer Guidance Maps:
Mental Model for the Maps Here is a simple mental model for the Developer Guidance Maps:
The Approach Rather than boil the ocean, I’ve used a systematic and repeatable approach. I’ve focused on common categories and features for key technologies and simple content types. Here is how we prioritized our focus:
The Maps are Works in Progress Keep in mind these maps are works in progress and they help us pressure test our simple information architecture (“Simple IA”) for developer guidance at Microsoft. Creating the maps also helps me test the model, create a catalog of developer guidance, and easily find the gaps and opportunities. While the maps are incomplete, they may help you find content and sources of content that you didn’t even know existed. For example, the All-In-One Code Framework has more than 450 code examples that cover 24 Microsoft development technologies such as Windows Azure, Windows 7, Silverlight, etc. … and the collection grows by six samples per week.
Here’s another powerful usage scenario. Use the maps as a template to create your own map for a particular technology. By creating a map or catalog of content for a specific technology, and organizing it by topic, feature, and content type, you can dramatically speed up your ability to map out a space and leverage existing knowledge. (… and you can share your maps with a friend ;)
My Related Posts
Do you think it would be possible to create a SharePoint Developer Guidance Map?
@ Voicu Seiche -- I think adding a SharePoint map would be a great addition. I don't currently have bandwidth, but I'll see if I can find somebody who wants to step up to the plate.