CodePlex, GE, and MSDN
One of the questions I get is how we build and publish our guides and what's the relationship of CodePlex, GE and MSDN. At a high-level, we build reusable guidance nuggets for customer questions and tasks. We then build a larger guide to bring the nuggets together into a story. Together, this gives us both a knowledge base of nuggets and a series of guides. We can incrementally deliver value, refactor as appropriate, and respond to changing needs.
Bird's-Eye View of Agile Guidance Engineering
You can think of our approach as progressive rendering of solutions (incrementally sharing and stabilizing.)
From CodePlex to MSDN
As we build guidance modules, we publish them to GE and CodePlex. GE lets you, the user, build more relevant views or tailor the nuggets to your own needs. CodePlex gives us a place to experiment with views and get direct user feedback, while we vet the guidance.
Once we're stable, we do a focused, batch effort to port to MSDN. MSDN gives us a bunch more channels and hooks including integration in Visual Studio / Visual Studio Team System.
There's much more to the story, so if there's interest, I'll share a behind the scenes look at how we build books.
My Related Posts
Comments
Anonymous
December 20, 2007
PingBack from http://geeklectures.info/2007/12/20/codeplex-ge-and-msdn/Anonymous
December 20, 2007
PingBack from http://geeklectures.info/2007/12/20/codeplex-ge-and-msdn/Anonymous
December 20, 2007
PingBack from http://msdnrss.thecoderblogs.com/2007/12/21/codeplex-ge-and-msdn/Anonymous
December 20, 2007
How do you build books? ;-) I would be interested to hear more. Thanks.Anonymous
December 20, 2007
Glad you asked! I'll post on how we build our books this coming week. It's worth going into some of the details since we definitely don't build books the traditional way.Anonymous
December 22, 2007
I am interested too.Anonymous
December 27, 2007
Book building is art and science. I've built a few books over the years at patterns & practices.Anonymous
August 10, 2008
I thought it might be helpful to walk through a deliverable so you can see my current approach for building