Welcome to MSDN Blogs Sign in | Join | Help

Team System User Education on Scenario Topics

Take a look at a proposal (Visual Studio Team System User Education : Scenario Topics) from David Chesnut of the Team System User Education Team that looks to replace the current orientation-style topics found in the product documentation with something a bit more useful. As always, your feedback is crucial and greatly appreciated.

To me, scenarios represent something fundamental. Documentation should map technology (e.g. work item lists) into the problem space the user is working in (e.g. to track project progress). These serve the same purpose as an abstract in a lengthy technical document: Telling the reader succinctly the key points of the content section so they can decide if they need to read any further.

Source: Visual Studio Team System User Education : Scenario Topics

1315

Published Monday, June 25, 2007 5:27 PM by Rob Caron

Comments

Tuesday, June 26, 2007 11:28 AM by Jim Glass

# re: Team System User Education on Scenario Topics

Kudo's to this team for advancing the state of the art in technical documentation. Or should I call it programming prose?  ;o)

Wednesday, July 11, 2007 8:19 AM by Team System News

# VSTS Links - 07/11/2007

Anthony Borton on Can't delete files from Document Library. Noad Coad on String.Equals Performance Comparison....

Wednesday, January 02, 2008 7:34 PM by Rob Caron

# More Team System User Education on Scenario Topics

Head over to the Team System User Education blog to get a look at a sample of what David Chesnut is calling

New Comments to this post are disabled
 
Page view tracker