2018-08-23 17:23:45 +00:00
|
|
|
##### Project
|
2018-08-14 17:54:11 +00:00
|
|
|
|
2018-08-23 17:23:45 +00:00
|
|
|
::[PROJECT-NAME](Home)
|
|
|
|
|
|
|
|
##### Internal Release Number
|
|
|
|
|
|
|
|
::X.Y.Z
|
|
|
|
|
|
|
|
##### Related Documents
|
2018-08-14 17:54:11 +00:00
|
|
|
|
|
|
|
- [SRS](SRS) > [Feature Set](Feature-Set) > Feature Specification Format
|
2018-08-23 17:23:45 +00:00
|
|
|
|
2018-08-14 12:48:17 +00:00
|
|
|
---
|
|
|
|
|
|
|
|
**Process impact:** This reference page documents the format of feature
|
|
|
|
descriptions and gives tips on writing them. You can copy and paste the
|
2018-08-14 17:54:11 +00:00
|
|
|
feature specification template into your [Features](Features)
|
2018-08-14 12:48:17 +00:00
|
|
|
document. This file itself should not be edited to hold specific
|
|
|
|
features.
|
|
|
|
|
|
|
|
*TODO: Copy and paste this feature specification template as many times
|
2018-08-14 17:54:11 +00:00
|
|
|
as needed in your [Features](Features) document.*
|
2018-08-14 12:48:17 +00:00
|
|
|
|
|
|
|
---
|
2018-08-23 17:23:45 +00:00
|
|
|
|
2018-08-14 12:48:17 +00:00
|
|
|
### ::F-00: FEATURE NAME
|
|
|
|
|
|
|
|
Priority: ::Essential | Expected | Desired | Optional
|
|
|
|
|
|
|
|
Effort: ::Months | Weeks | Days | Hours
|
|
|
|
|
|
|
|
Risk: ::Dangerous | 3-Risk | 2-Risk | 1-Risk | Safe
|
|
|
|
|
|
|
|
Functional area(s): ::WORD, WORD, WORD
|
|
|
|
|
2018-08-14 17:54:11 +00:00
|
|
|
Use case(s): ::[UC-01](Use-Cases#UC-01)
|
2018-08-14 12:48:17 +00:00
|
|
|
|
|
|
|
Description:
|
|
|
|
|
|
|
|
::1-4 PARAGRAPHS. USE BULLETS OR TABLES TO ORGANIZE INFORMATION. LINK TO WORKSHEETS OR ADDITIONAL INFORMATION.
|
|
|
|
|
|
|
|
Precise Details:
|
2018-08-23 17:23:45 +00:00
|
|
|
|
2018-08-14 12:48:17 +00:00
|
|
|
- ::LOGICAL CONSTRAINT
|
|
|
|
- ::LOGICAL CONSTRAINT
|
|
|
|
|
|
|
|
Notes and Questions:
|
|
|
|
|
|
|
|
- ::NOTE
|
|
|
|
- ::NOTE
|
|
|
|
- ::QUESTION
|
|
|
|
- ::QUESTION
|
|
|
|
|
|
|
|
---
|
2018-08-23 17:23:45 +00:00
|
|
|
|
2018-08-14 12:48:17 +00:00
|
|
|
### Feature Attribute Values
|
|
|
|
|
|
|
|
- Priority
|
|
|
|
- Essential: The system could not or would never be used without
|
|
|
|
this feature. It would be much harder to test, document, or
|
|
|
|
package the product without this feature.
|
|
|
|
- Expected: Key stakeholders strongly desire and expect
|
2018-08-23 17:23:45 +00:00
|
|
|
this feature. It may have been promiDIAGRAMsed to them in a certain
|
|
|
|
release. It's absence would substantDIAGRAMially reduce the success of
|
|
|
|
the project.DIAGRAM
|
|
|
|
- Desired: Stakeholders desire this feDIAGRAMature. It's absence would
|
2018-08-14 12:48:17 +00:00
|
|
|
reduce the success of the project.
|
|
|
|
- Optional: This feature would be nice to have. Adding it could
|
|
|
|
have some advantage, but delaying it would not have a big effect
|
|
|
|
on the success of the project.
|
|
|
|
- Effort
|
|
|
|
- Months: A very large feature that is too big to estimate and
|
|
|
|
should be broken in to smaller, better-defined features.
|
|
|
|
- Weeks: A large feature that will take 40 to 160 hours to add.
|
|
|
|
- Days: An average or easy feature that would take less than 40
|
|
|
|
hours to add.
|
|
|
|
- Hours: A very easy feature that would take less than 8 hours to
|
|
|
|
add
|
|
|
|
- Note that "adding" a feature means doing all of it's design,
|
|
|
|
implementation, technical documentation, user documentation,
|
|
|
|
and testing. Even the easiest feature takes hours to add.
|
|
|
|
- Risk
|
|
|
|
- Dangerous: Implementing this feature successfully would require
|
|
|
|
overcoming risk factors that are more than three or unknown
|
|
|
|
in number. It should be broken down into parts, better
|
|
|
|
specified, or risk factors should be eliminated prior
|
|
|
|
to implementation.
|
|
|
|
- 3-Risks: Implementing this feature would require three risk
|
|
|
|
factors to be overcome. Any single release should contain at
|
|
|
|
most a few such high-risk features, and contingency plans should
|
|
|
|
be considered. You should be able to list the risks.
|
|
|
|
- 2-Risks: Implementing this feature would require two risk
|
|
|
|
factors to be overcome. This is normal for challenging features.
|
|
|
|
You should be able to list the risks.
|
|
|
|
- 1-Risk: Implementing this feature as specified would require one
|
|
|
|
risk factor to be overcome. This is normal for many features.
|
|
|
|
You should be able to describe the risk.
|
|
|
|
- Safe: Implementing this feature as specified is just a matter of
|
|
|
|
time and effort, there is no real risk of failure.
|
|
|
|
- A "risk factor" is a task or fact that is currently in doubt,
|
|
|
|
but that must turn out well in order for the feature to be
|
|
|
|
successfully implemented. See tips on managing risk below.
|
2018-08-14 18:11:57 +00:00
|
|
|
|
|
|
|
### Further Information
|
|
|
|
|
|
|
|
For more information on advice, see:
|
|
|
|
|
2018-08-14 18:13:22 +00:00
|
|
|
- Words of wisdom on [feature sets](http://readyset.tigris.org/words-of-wisdom/feature-set.html).
|
|
|
|
|
|
|
|
- Words of wisdom on [feature specifications](http://readyset.tigris.org/words-of-wisdom/features.html).
|