Return to
HomePage
Template
* Title
* Applies To
* Summary
* Contents
* Body
* Additional Resources
* Feedback
* Community and Newsgroup
* Contributors and Reviewers
Test Cases
Title
*
Does the title distinguish by product or version where possible? *
Are important nouns a user might scan for towards the left of the title? Applies To
*
Is it clear what technologies or products this applies to? *
Conversely, is it clear what technologies of products this does not apply to?Summary
*
Does the summary pass the ‘hallway test’ – would this be your verbal description the module’s purpose? *
Is the summary short and to the point?Contents
*
Is each major heading listed?Body
*
Does the At a Glance summarize the key concepts of the underlying document? *
Is the At a Glance too long to be a good summary? *
Does the At a Glance dive into details that are best left in the underlying document?Additional Resources
*
Is a link back to the appropriate index included? *
Is a link to the document this At a Glance is summarizing included? *
For each link, do you know why the link is included without first following the link?Feedback
*
Is there a way to provide feedback?Community and Newsgroup
*
Is there a list of community sites?Contributors and Reviewers
*
Is there at least one name associated with each category? * External Contributors and Reviewers
* Microsoft Product Group Contributors and Reviewers
* Name (PG Name); Microsoft IT Contributors and Reviewers
* Microsoft Services and PSS Contributors and Reviewers
* Microsoft patterns & practices Contributors and Reviewers
* Test Team
* Edit Team
* Release Management
Return to
HomePage