ERW: as a agilist in general and a fan of test-first in particular, I'd personally like to state the requirements in terms of verifiable assertions rather than more formal requirements. This being a wiki, anybody who doesn't agree can just change it to a form they like and I'll live with it :)
Requirements (aka Desired Features)
Initial requirements are based on the Project Vertigo
Vision Statement.
General Display Requirements
| Iteration | Rqmnt # | Requirement | Done |
|---|
| Iteration 1 | GD1.0 | The tree displays all changeset identifiers in the current branch's history for the selected version | Yes |
| Iteration 2 | GD2.0 | The tree displays labels applied to a version next to the version's icon | No |
| Iteration 2 | GD3.0 | The tree visually identifies branching operations performed on a version. | No |
| Iteration 2 | GD4.0 | Hovering over a version's icon displays the name of the user that created that version | No |
| Iteration 2 | GD5.0 | Hovering over a version's icon displays the checkin comment associated with that version, if any | No |
| Iteration 2 | GD6.0 | The tree can be expanded or collapsed to support focusing on the relevant information. | No |
| Iteration 3 | GD7.0 | Hovering over a version's icon displays a list of work item identifiers and work item titles that are associated (linked) to the changeset containing that version. | No |
| Backlog | GD8.0 | The tree can be printed. | No |
| Backlog | GD9.0 | The user can reorganize the tree using click and drag behavior | No |
Windows Forms Client Requirements
| Iteration | Rqmnt # | Requirement | Done |
|---|
| Iteration 1 | WF1.0 | The WinForm client allows the user to specify the Team Foundation Server (and port) to query against | Yes |
| Iteration 1 | WF2.0 | The WinForm client allows the user to specify the versioned item for which the version tree is displayed. | Yes |
| Iteration 1 | CX1.0 | (Design Constraint) The WinForm client retrieves the needed data using a class library specific to the task of querying version history for an item. | Yes |
| Iteration 1 | CX2.0 | (Design Constraint) The WinForm client displays the version tree in a stand-alone UserControl. This control should require minimal initial configuration. | Yes |
Visual Studio IDE Client Requirements
| Iteration | Rqmnt # | Requirement | Done |
|---|
| Backlog | VS1.0 | "View version tree" appears on the right click menu for files in the VS source control explorer window | No |
| Backlog | VS2.0 | "View version tree" appears on the right click menu for entries in the VS History Window | No |
| Backlog | VS3.0 | "View version tree" appears on the right click menu for entries in the VS Pending Change Window | No |
Command Line Client Requirements
| Iteration | Rqmnt # | Requirement | Done |
|---|
| Backlog | CL1.0 | The command line client displays the WinForm client for the specified item | No |
Removed Requirements
Use this to keep the ones we don't want around for reference | Iteration | Rqmnt # | Requirement | Section |
|---|
Definitions
- "The Tree" - The graphical representation for the version history of a given versioned item.
- "Version's Icon" - The graphical represntation for a single version of an item in the tree.
Change Log| Date | User | Comment |
|---|
| 29-jun-2006 01:27 GMT -5:00 | MR | Added Rqmnt # to tables for easier reference and traceability. Added Wiki page for any requirement that needed further discussion, clarification for drill down and detail |