Guideline: Defining a Practice Configuration Welcome Page
This guideline provides recommendations for defining Welcome pages for practice configuration.
Main Description

Every Practice Configuration should have a Welcome page that clearly states the purpose, scope and intended audience for the configuration. 

It is also a good idea to describe, at a high-level, how the practices included in the configuration fit together (remember, a practice configuration is more than just a collection of practices). This high-level description may be in any format, whether that be textual (like a roadmap) or graphical (like an activity diagram, flow chart, capability pattern, etc.). Treat this overview as though it were the introduction to a book (where the practice configuration is the book).  It should give the reader the lay of the land without going into too much detail.

In addition, if the practice configuration includes multiple navigation views, each addressing the navigation needs of a particular type of user, it is usually a good idea to describe what navigation views are available and when you should use one versus the other. For more information on navigation views, see Guideline: Defining Navigation Views.

The Welcome page is also a good place to link to release information for the configuration.

Welcome pages are defined as supporting material guidance elements with a special icon.


Special instructions when authoring in the UMF: When defining a practice configuration-specific welcome page in the Unified Method Framework (UMF), the welcome page should be defined to replace (using variability) the generic welcome page defined for the generic navigation view. For more information on variability, see Guideline: Using Method Content Variability. For more information on the generic navigation view, see Guideline: Navigation Views in the UMF

The practice configuration-specific welcome page should specify the same special icons for the welcome page as defined for the generic welcome page.

More Information