lint formatting fixes
This commit is contained in:
parent
bbf98a0dde
commit
7e0a90c44e
@ -1,26 +1,33 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
|
||||||
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
|
##### Internal Release Number
|
||||||
|
|
||||||
##### Internal Release Number:
|
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
|
|
||||||
- [Project proposal](Proposal) > [Target audience and benefits](Target-and-Benefits)
|
- [Project proposal](Proposal) > [Target audience and benefits](Target-and-Benefits)
|
||||||
- [SRS](SRS) > [Use case suite](Use-Case-Suite)
|
- [SRS](SRS) > [Use case suite](Use-Case-Suite)
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
- ::LINKS TO OTHER DOCUMENTS
|
- ::LINKS TO OTHER DOCUMENTS
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Demo Planning
|
### Demo Planning
|
||||||
|
|
||||||
*TODO: Think through your goals for this demo.*
|
*TODO: Think through your goals for this demo.*
|
||||||
|
|
||||||
#### Who is the target audience for this demo?
|
#### Who is the target audience for this demo?
|
||||||
|
|
||||||
- ::Investors and potential investors
|
- ::Investors and potential investors
|
||||||
- ::Potential customers
|
- ::Potential customers
|
||||||
- ::Management, other developers, or partners
|
- ::Management, other developers, or partners
|
||||||
- ::End users as part of training
|
- ::End users as part of training
|
||||||
|
|
||||||
#### What is your main goal for this demo?
|
#### What is your main goal for this demo?
|
||||||
|
|
||||||
- ::To convince the audience to make a decision and take action. E.g., a
|
- ::To convince the audience to make a decision and take action. E.g., a
|
||||||
sales call.
|
sales call.
|
||||||
- ::To inform the audience about the product and prompt
|
- ::To inform the audience about the product and prompt
|
||||||
@ -30,6 +37,7 @@
|
|||||||
are done with the UI.
|
are done with the UI.
|
||||||
|
|
||||||
#### What main points will you use to achieve your goal?
|
#### What main points will you use to achieve your goal?
|
||||||
|
|
||||||
- ::This product automates much of the user's task, thus increasing
|
- ::This product automates much of the user's task, thus increasing
|
||||||
productivity and cutting costs.
|
productivity and cutting costs.
|
||||||
- ::This product is very easy to use, which will encourage
|
- ::This product is very easy to use, which will encourage
|
||||||
@ -43,11 +51,13 @@
|
|||||||
the remaining features cannot possibly work like the others.
|
the remaining features cannot possibly work like the others.
|
||||||
|
|
||||||
#### How much time is available to present the demo?
|
#### How much time is available to present the demo?
|
||||||
|
|
||||||
- ::10 minutes, no questions
|
- ::10 minutes, no questions
|
||||||
- ::10 minutes, plus questions
|
- ::10 minutes, plus questions
|
||||||
- ::30 minutes, including questions
|
- ::30 minutes, including questions
|
||||||
|
|
||||||
#### What equipment and setup is needed to give the demo?
|
#### What equipment and setup is needed to give the demo?
|
||||||
|
|
||||||
- ::One person. Any computer with a web browser.
|
- ::One person. Any computer with a web browser.
|
||||||
- ::One person. Any computer where we can install from CD or
|
- ::One person. Any computer where we can install from CD or
|
||||||
the Internet.
|
the Internet.
|
||||||
@ -56,6 +66,7 @@
|
|||||||
with a wireless networking card.
|
with a wireless networking card.
|
||||||
|
|
||||||
### Demo Script
|
### Demo Script
|
||||||
|
|
||||||
*TODO: Outline the steps of the demo. Plan out what you will do and say.
|
*TODO: Outline the steps of the demo. Plan out what you will do and say.
|
||||||
Practice three times to make sure that all system features actually work
|
Practice three times to make sure that all system features actually work
|
||||||
as needed, and that there is enough time.*
|
as needed, and that there is enough time.*
|
||||||
@ -66,6 +77,7 @@ you interested? What are your questions or concerns? Do you strongly
|
|||||||
disagree with any points?*
|
disagree with any points?*
|
||||||
|
|
||||||
#### ::Beginning
|
#### ::Beginning
|
||||||
|
|
||||||
- ::SET EXPECTATIONS
|
- ::SET EXPECTATIONS
|
||||||
- ::SET THE STAGE
|
- ::SET THE STAGE
|
||||||
- ::KEY POINT
|
- ::KEY POINT
|
||||||
@ -73,6 +85,7 @@ disagree with any points?*
|
|||||||
- ::DEMO STEP
|
- ::DEMO STEP
|
||||||
|
|
||||||
#### ::Middle
|
#### ::Middle
|
||||||
|
|
||||||
- ::KEY POINT
|
- ::KEY POINT
|
||||||
- ::DEMO STEP
|
- ::DEMO STEP
|
||||||
- ::DEMO STEP
|
- ::DEMO STEP
|
||||||
@ -80,10 +93,11 @@ disagree with any points?*
|
|||||||
- ::DEMO STEP
|
- ::DEMO STEP
|
||||||
- ::DEMO STEP
|
- ::DEMO STEP
|
||||||
- ::KEY POINT (if there is time)
|
- ::KEY POINT (if there is time)
|
||||||
- ::DEMO STEP
|
- ::DEMO STEP
|
||||||
- ::DEMO STEP
|
- ::DEMO STEP
|
||||||
|
|
||||||
#### ::Ending
|
#### ::Ending
|
||||||
|
|
||||||
- ::FINAL POINT
|
- ::FINAL POINT
|
||||||
- ::DEMO STEP
|
- ::DEMO STEP
|
||||||
- ::DEMO STEP
|
- ::DEMO STEP
|
||||||
@ -99,26 +113,32 @@ good answers.*
|
|||||||
use them if someone asks a question.*
|
use them if someone asks a question.*
|
||||||
|
|
||||||
#### ::How does this compare to OTHER-PRODUCT?
|
#### ::How does this compare to OTHER-PRODUCT?
|
||||||
|
|
||||||
::ANSWER
|
::ANSWER
|
||||||
|
|
||||||
#### ::What happens if you do X or Y?
|
#### ::What happens if you do X or Y?
|
||||||
|
|
||||||
::It would do Z.
|
::It would do Z.
|
||||||
|
|
||||||
#### ::When will your product be ready?
|
#### ::When will your product be ready?
|
||||||
|
|
||||||
- ::We have announced a release date of July 17th.
|
- ::We have announced a release date of July 17th.
|
||||||
- ::We are planning a release this Winter, but no specific date has
|
- ::We are planning a release this Winter, but no specific date has
|
||||||
been set.
|
been set.
|
||||||
- ::We have not announced a release date yet.
|
- ::We have not announced a release date yet.
|
||||||
|
|
||||||
### Demo Checklist
|
### Demo Checklist
|
||||||
|
|
||||||
*TODO: Use the following questions to help you evaluate your demo.*
|
*TODO: Use the following questions to help you evaluate your demo.*
|
||||||
|
|
||||||
#### Are you making the right points in the right order?
|
#### Are you making the right points in the right order?
|
||||||
|
|
||||||
::Yes, we feel that we will accomplish our goals.
|
::Yes, we feel that we will accomplish our goals.
|
||||||
|
|
||||||
::No, we need to better prioritize our points.
|
::No, we need to better prioritize our points.
|
||||||
|
|
||||||
#### Can it be presented in the available time?
|
#### Can it be presented in the available time?
|
||||||
|
|
||||||
::Yes, we could even add more or finish early.
|
::Yes, we could even add more or finish early.
|
||||||
|
|
||||||
::Yes, we have optional sections that can be skipped to save time
|
::Yes, we have optional sections that can be skipped to save time
|
||||||
@ -130,6 +150,7 @@ fewer points.
|
|||||||
::No, we need to change the available time.
|
::No, we need to change the available time.
|
||||||
|
|
||||||
#### Do all system features actually work as needed?
|
#### Do all system features actually work as needed?
|
||||||
|
|
||||||
::Yes, everything is finished and working.
|
::Yes, everything is finished and working.
|
||||||
|
|
||||||
::Yes, there are defects, but they will not matter for this demo.
|
::Yes, there are defects, but they will not matter for this demo.
|
||||||
@ -141,6 +162,7 @@ something fails.
|
|||||||
our points without exposing defects.
|
our points without exposing defects.
|
||||||
|
|
||||||
#### Does the demo end effectively?
|
#### Does the demo end effectively?
|
||||||
|
|
||||||
::Yes, viewers will be satisfied and convinced.
|
::Yes, viewers will be satisfied and convinced.
|
||||||
|
|
||||||
::No, we need to make sure the demo stops at the natural end of a
|
::No, we need to make sure the demo stops at the natural end of a
|
||||||
@ -148,6 +170,7 @@ small but complete story, and that audience members understand our
|
|||||||
key points.
|
key points.
|
||||||
|
|
||||||
#### Does the demo raise questions that it does not answer?
|
#### Does the demo raise questions that it does not answer?
|
||||||
|
|
||||||
::No, the demo is very complete.
|
::No, the demo is very complete.
|
||||||
|
|
||||||
::Yes, but we anticipate those questions and can handle them in the
|
::Yes, but we anticipate those questions and can handle them in the
|
||||||
|
@ -1,15 +1,19 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::PROJECTNAME(Home)
|
|
||||||
|
::PROJECT-NAME(Home)
|
||||||
|
|
||||||
|
##### Internal Release Number
|
||||||
|
|
||||||
##### Internal Release Number:
|
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
|
|
||||||
- [Design](Design) > Design Architecture
|
- [Design](Design) > Design Architecture
|
||||||
- [Software Requirements Specification](SRS)
|
- [Software Requirements Specification](SRS)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
- ::LINKS TO OTHER DOCUMENTS
|
- ::LINKS TO OTHER DOCUMENTS
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
*TODO: Answer the questions below to help you define your system
|
*TODO: Answer the questions below to help you define your system
|
||||||
@ -49,11 +53,11 @@ architecture. Some example text is provided.*
|
|||||||
::The components of this system are listed below by type:
|
::The components of this system are listed below by type:
|
||||||
|
|
||||||
- ::Presentation/UI Components
|
- ::Presentation/UI Components
|
||||||
- ::[C-00: COMPONENTNAME](Design-Components#c-00)
|
- ::[C-00: COMPONENT-NAME](Design-Components#c-00)
|
||||||
- ::Application Logic Components
|
- ::Application Logic Components
|
||||||
- ::[C-10: COMPONENTNAME](Design-Components#c-10)
|
- ::[C-10: COMPONENT-NAME](Design-Components#c-10)
|
||||||
- ::Data Storage Components
|
- ::Data Storage Components
|
||||||
- ::[C-20: COMPONENTNAME](Design-Components#c-20)
|
- ::[C-20: COMPONENT-NAME](Design-Components#c-20)
|
||||||
|
|
||||||
### Deployment
|
### Deployment
|
||||||
|
|
||||||
@ -68,24 +72,24 @@ defined below:
|
|||||||
- ::All-in-one server
|
- ::All-in-one server
|
||||||
- ::Tomcat process
|
- ::Tomcat process
|
||||||
- ::[C-00: Tomcat web server](Design-Components#c-00)
|
- ::[C-00: Tomcat web server](Design-Components#c-00)
|
||||||
- ::[C-10: PROJECTNAME
|
- ::[C-10: PROJECT-NAME
|
||||||
application](Design-Components#c-10)
|
application](Design-Components#c-10)
|
||||||
- ::Database process
|
- ::Database process
|
||||||
- ::[C-20: COMPONENTNAME](Design-Components#c-30)
|
- ::[C-20: COMPONENT-NAME](Design-Components#c-30)
|
||||||
|
|
||||||
::The deployment of components to processes and machines is clearly
|
::The deployment of components to processes and machines is clearly
|
||||||
defined below:
|
defined below:
|
||||||
|
|
||||||
- ::Load-balanced front-end servers
|
- ::Load-balanced front-end servers
|
||||||
- ::[C-01: COMPONENTNAME](Design-Components#c-00)
|
- ::[C-01: COMPONENT-NAME](Design-Components#c-00)
|
||||||
- ::Back-end server
|
- ::Back-end server
|
||||||
- ::JVM process
|
- ::JVM process
|
||||||
- ::[C-00: COMPONENTNAME](Design-Components#c-00)
|
- ::[C-00: COMPONENT-NAME](Design-Components#c-00)
|
||||||
- ::[C-10: COMPONENTNAME](Design-Components#c-10)
|
- ::[C-10: COMPONENT-NAME](Design-Components#c-10)
|
||||||
- ::[C-11: PLUG-IN COMPONENTNAME](Design-Components#c-11)
|
- ::[C-11: PLUG-IN COMPONENT-NAME](Design-Components#c-11)
|
||||||
- ::[C-12: PLUG-IN COMPONENTNAME](Design-Components#c-12)
|
- ::[C-12: PLUG-IN COMPONENT-NAME](Design-Components#c-12)
|
||||||
- Database process
|
- Database process
|
||||||
- ::[C-20: COMPONENTNAME](Design-Components#c-30)
|
- ::[C-20: COMPONENT-NAME](Design-Components#c-30)
|
||||||
|
|
||||||
#### What aspects/resources of their environment are shared?
|
#### What aspects/resources of their environment are shared?
|
||||||
|
|
||||||
@ -120,7 +124,6 @@ split or load-balanced.
|
|||||||
|
|
||||||
### Integration
|
### Integration
|
||||||
|
|
||||||
|
|
||||||
#### How will components be integrated? Specifically, how will they communicate?
|
#### How will components be integrated? Specifically, how will they communicate?
|
||||||
|
|
||||||
::All of our code uses direct procedure calls. The database is
|
::All of our code uses direct procedure calls. The database is
|
||||||
@ -166,14 +169,17 @@ components communicate during some important usage scenarios:
|
|||||||
*TODO: Evaluate your architecture with respect to each of your goals.*
|
*TODO: Evaluate your architecture with respect to each of your goals.*
|
||||||
|
|
||||||
#### Ease of integration: Have mechanisms been provided for all needed types of integration?
|
#### Ease of integration: Have mechanisms been provided for all needed types of integration?
|
||||||
|
|
||||||
::Yes. In this system, all of the new components are designed to
|
::Yes. In this system, all of the new components are designed to
|
||||||
work together. And, the reused components are integrated via fairly
|
work together. And, the reused components are integrated via fairly
|
||||||
simple interfaces.
|
simple interfaces.
|
||||||
|
|
||||||
#### Extensibility: What types of components can be added later and how?
|
#### Extensibility: What types of components can be added later and how?
|
||||||
|
|
||||||
::See above.
|
::See above.
|
||||||
|
|
||||||
#### Capacity matching: How has this architecture matched component resource needs to machines?
|
#### Capacity matching: How has this architecture matched component resource needs to machines?
|
||||||
|
|
||||||
::The database can be on a machine with RAID disks and a hot-swappable
|
::The database can be on a machine with RAID disks and a hot-swappable
|
||||||
power supply, while the web front-end components can be on cheaper
|
power supply, while the web front-end components can be on cheaper
|
||||||
machines that could fail individually without causing
|
machines that could fail individually without causing
|
||||||
|
@ -1,11 +1,14 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::PROJECTNAME
|
|
||||||
|
::PROJECT-NAME
|
||||||
|
|
||||||
|
##### Internal Release Number
|
||||||
|
|
||||||
##### Internal Release Number:
|
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Design](Design)> [Architecture](Design-Architecture) > Design Components
|
|
||||||
|
- [Design](Design) > [Architecture](Design-Architecture) > Design Components
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
- ::LINKS TO OTHER DOCUMENTS
|
- ::LINKS TO OTHER DOCUMENTS
|
||||||
|
|
||||||
|
@ -1,10 +1,10 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::PROJECTNAME
|
::PROJECT-NAME
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Design](Design) > Design Persistence
|
- [Design](Design) > Design Persistence
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
- ::LINKS TO OTHER DOCUMENTS
|
- ::LINKS TO OTHER DOCUMENTS
|
||||||
@ -99,8 +99,12 @@ attachments are written to files on the server hard disk.
|
|||||||
::N/A
|
::N/A
|
||||||
|
|
||||||
::Files are stored on the server as
|
::Files are stored on the server as
|
||||||
|
|
||||||
```/var/data/attachments/msgNNNN-MMM.dat```
|
```bash
|
||||||
|
|
||||||
|
/var/data/attachments/msgNNNN-MMM.dat
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
::Users store files anywhere on their computer, with the filename
|
::Users store files anywhere on their computer, with the filename
|
||||||
extension ```.TST```.
|
extension ```.TST```.
|
||||||
@ -111,7 +115,7 @@ extension ```.TST```.
|
|||||||
|
|
||||||
::Files for message attachments are only readable and writable by the
|
::Files for message attachments are only readable and writable by the
|
||||||
mailing list archiving process that runs as operating system
|
mailing list archiving process that runs as operating system
|
||||||
user "archdaemon".
|
user "daemon".
|
||||||
|
|
||||||
::Users can use whatever file permissions they like.
|
::Users can use whatever file permissions they like.
|
||||||
|
|
||||||
@ -151,7 +155,6 @@ kept indefinitely.
|
|||||||
|
|
||||||
### Persistence Mechanisms Checklist
|
### Persistence Mechanisms Checklist
|
||||||
|
|
||||||
|
|
||||||
#### Expressiveness: To what extent has this been achieved?
|
#### Expressiveness: To what extent has this been achieved?
|
||||||
|
|
||||||
::2-4 SENTENCES
|
::2-4 SENTENCES
|
||||||
|
@ -1,13 +1,17 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::PROJECTNAME
|
|
||||||
|
::PROJECT-NAME
|
||||||
|
|
||||||
|
##### Internal Release Number
|
||||||
|
|
||||||
##### Internal Release Number:
|
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
|
|
||||||
- [Design](Design) > Scalability
|
- [Design](Design) > Scalability
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
- ::LINKS TO OTHER DOCUMENTS
|
- ::LINKS TO OTHER DOCUMENTS
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Overview
|
### Overview
|
||||||
@ -28,7 +32,6 @@ scalability goals for this design.*
|
|||||||
|
|
||||||
### Scalability Mechanisms
|
### Scalability Mechanisms
|
||||||
|
|
||||||
|
|
||||||
### Performance Goals and Estimates
|
### Performance Goals and Estimates
|
||||||
|
|
||||||
| Action | Goal | Time Formula | Description |
|
| Action | Goal | Time Formula | Description |
|
||||||
|
@ -1,13 +1,15 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::PROJECTNAME
|
::PROJECT-NAME
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
|
|
||||||
- [Design](Design) > Design Security
|
- [Design](Design) > Design Security
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
- ::LINKS TO OTHER DOCUMENTS
|
- ::LINKS TO OTHER DOCUMENTS
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Overview
|
### Overview
|
||||||
@ -87,7 +89,7 @@ features. Some example text is provided. Add or delete text as needed.*
|
|||||||
- ::Users must have certificate files on their client machine before
|
- ::Users must have certificate files on their client machine before
|
||||||
they can connect to the server
|
they can connect to the server
|
||||||
- ::Users must have physical security tokens (e.g., hasp, dongle,
|
- ::Users must have physical security tokens (e.g., hasp, dongle,
|
||||||
smartcard, or fingerprint reader)
|
smart-card, or fingerprint reader)
|
||||||
- ::Users are given roles that define their permissions. Those roles
|
- ::Users are given roles that define their permissions. Those roles
|
||||||
are:
|
are:
|
||||||
- ::Guest: Visitor to the site is not logged in, no permissions
|
- ::Guest: Visitor to the site is not logged in, no permissions
|
||||||
@ -101,10 +103,10 @@ features. Some example text is provided. Add or delete text as needed.*
|
|||||||
- ::Each action (information display or change) requires that the
|
- ::Each action (information display or change) requires that the
|
||||||
user has a role with proper permissions
|
user has a role with proper permissions
|
||||||
- ::Compromised or abused accounts can be quickly disabled
|
- ::Compromised or abused accounts can be quickly disabled
|
||||||
by administrators. >
|
by administrators. >
|
||||||
- ::Administrators can review user > permissions
|
- ::Administrators can review user > permissions
|
||||||
- ::Administrators can audit all a > ccesses and changes
|
- ::Administrators can audit all a > ccesses and changes
|
||||||
- ::All communications with the us > er are encrypted (e.g., SSL)
|
- ::All communications with the us > er are encrypted (e.g., SSL)
|
||||||
- ::Some communications with the user (e.g., the username
|
- ::Some communications with the user (e.g., the username
|
||||||
and password) are encrypted (e.g., SSL)
|
and password) are encrypted (e.g., SSL)
|
||||||
- ::Sessions are tied to a particular client IP-address so that
|
- ::Sessions are tied to a particular client IP-address so that
|
||||||
@ -131,7 +133,6 @@ features. Some example text is provided. Add or delete text as needed.*
|
|||||||
|
|
||||||
### Security Checklist
|
### Security Checklist
|
||||||
|
|
||||||
|
|
||||||
#### Protection of data: To what extent has this been achieved?
|
#### Protection of data: To what extent has this been achieved?
|
||||||
|
|
||||||
::2-4 SENTENCES
|
::2-4 SENTENCES
|
||||||
@ -145,6 +146,7 @@ features. Some example text is provided. Add or delete text as needed.*
|
|||||||
::2-4 SENTENCES
|
::2-4 SENTENCES
|
||||||
|
|
||||||
#### Accountability/auditing: To what extent has this been achieved?
|
#### Accountability/auditing: To what extent has this been achieved?
|
||||||
|
|
||||||
::2-4 SENTENCES
|
::2-4 SENTENCES
|
||||||
|
|
||||||
#### Have these security mechanisms been communicated to the development team and other stakeholders?
|
#### Have these security mechanisms been communicated to the development team and other stakeholders?
|
||||||
|
@ -1,15 +1,19 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::PROJECTNAME
|
|
||||||
|
::PROJECT-NAME
|
||||||
|
|
||||||
|
##### Internal Release Number
|
||||||
|
|
||||||
##### Internal Release Number:
|
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
|
|
||||||
- [Design](Design) > Source Code Organization and Build System
|
- [Design](Design) > Source Code Organization and Build System
|
||||||
- ::[Example build.xml for Tomcat](http://jakarta.apache.org/tomcat/tomcat-4.1-doc/appdev/build.xml.txt)
|
- ::[Example build.xml for Tomcat](http://jakarta.apache.org/tomcat/tomcat-4.1-doc/appdev/build.xml.txt)
|
||||||
- ::[Apache Ant manual](http://ant.apache.org/manual/index)
|
- ::[Apache Ant manual](http://ant.apache.org/manual/index)
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
- ::LINKS TO OTHER DOCUMENTS
|
- ::LINKS TO OTHER DOCUMENTS
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Overview
|
### Overview
|
||||||
@ -20,6 +24,7 @@ delete text as needed. E.g., not all projects try to be platform
|
|||||||
independent.*
|
independent.*
|
||||||
|
|
||||||
#### What are the most important facts that a developer should know about this source code organization and build system?
|
#### What are the most important facts that a developer should know about this source code organization and build system?
|
||||||
|
|
||||||
::It roughly follows the standard proposed in the Tomcat documentation
|
::It roughly follows the standard proposed in the Tomcat documentation
|
||||||
and is very similar to the organization used on many open source
|
and is very similar to the organization used on many open source
|
||||||
projects at the Apache Software Foundation.
|
projects at the Apache Software Foundation.
|
||||||
@ -58,7 +63,7 @@ overall structure or build process.*
|
|||||||
| ::build/ | ::No | ::Output of build process |
|
| ::build/ | ::No | ::Output of build process |
|
||||||
| ::build/WEB-INF/classes/ | ::No | ::Compiled code output by build process |
|
| ::build/WEB-INF/classes/ | ::No | ::Compiled code output by build process |
|
||||||
| ::dist/docs/api/ | ::No | ::API documentation output from build process |
|
| ::dist/docs/api/ | ::No | ::API documentation output from build process |
|
||||||
| ::dist/PROJECTNAME-VERSION.war | ::No | ::Deployable web archive of classes and config files generated by build process |
|
| ::dist/PROJECT-NAME-VERSION.war | ::No | ::Deployable web archive of classes and config files generated by build process |
|
||||||
|
|
||||||
### Build Targets
|
### Build Targets
|
||||||
|
|
||||||
@ -68,11 +73,10 @@ development. The examples below should fit most projects.*
|
|||||||
| Target | Description |
|
| Target | Description |
|
||||||
|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||||||
| ::compile = default | ::Compiles Java source code and creates .class files under the "build" directory. |
|
| ::compile = default | ::Compiles Java source code and creates .class files under the "build" directory. |
|
||||||
| ::dist | ::Packages the system for distribution/deployment to servers or end users. Specifically, it creates .war archive of compiled classes and configuration files. |
|
| ::dist | ::Packages the system for distribution/deployment to servers or end users. Specifically, it creates .war archive of compiled classes and configuration files. |
|
||||||
| ::install | ::Places executable code into location where it will actually be executed. Specifically, it copies .war file into Tomcat's webapps directory for use. You must then restart Tomcat or use the "reload" link in the Tomcat Manager. |
|
| ::install | ::Places executable code into location where it will actually be executed. Specifically, it copies .war file into Tomcat's webapps directory for use. You must then restart Tomcat or use the "reload" link in the Tomcat Manager. |
|
||||||
| ::javadoc | ::Generates Java API documentation under "build/docs/api/". |
|
| ::javadoc | ::Generates Java API documentation under "build/docs/api/". |
|
||||||
| ::clean | ::Deletes files generated by previous build commands. Files under version control are not touched. |
|
| ::clean | ::Deletes files generated by previous build commands. Files under version control are not touched. |
|
||||||
|
|
||||||
|
|
||||||
### Build Configuration Options
|
### Build Configuration Options
|
||||||
|
|
||||||
|
78
Design-UI.md
78
Design-UI.md
@ -1,13 +1,17 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::PROJECTNAME
|
|
||||||
|
::PROJECT-NAME
|
||||||
|
|
||||||
|
##### Internal Release Number
|
||||||
|
|
||||||
##### Internal Release Number:
|
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
|
|
||||||
- [Design](Design) > User Interface
|
- [Design](Design) > User Interface
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
- ::LINKS TO OTHER DOCUMENTS
|
- ::LINKS TO OTHER DOCUMENTS
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Overview
|
### Overview
|
||||||
@ -29,7 +33,6 @@ text as needed.*
|
|||||||
|
|
||||||
### Metaphors, Exemplars, and Standards
|
### Metaphors, Exemplars, and Standards
|
||||||
|
|
||||||
|
|
||||||
#### What is the central metaphor of this UI design?
|
#### What is the central metaphor of this UI design?
|
||||||
|
|
||||||
::PARAGRAPH
|
::PARAGRAPH
|
||||||
@ -88,38 +91,37 @@ interaction contexts. A use case that requires three interaction
|
|||||||
contexts could be hard to use. However, interaction contexts with too
|
contexts could be hard to use. However, interaction contexts with too
|
||||||
many components can also be hard to use.*
|
many components can also be hard to use.*
|
||||||
|
|
||||||
| Interaction Context --Abstract UI Components | Purpose | Contents / Constraints / Behavior |
|
| Interaction Context --Abstract UI Components | Purpose | Contents / Constraints / Behavior |
|
||||||
|------------------------------------------------|------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|------------------------------------------------|------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||||||
| ::[Login dialog](LINK-TO-MOCKUP) | ::Verify that the current user is actually the person that they claim to be. | |
|
| ::[Login dialog](LINK-TO-MOCKUP) | ::Verify that the current user is actually the person that they claim to be. | |
|
||||||
| ::--Prompt | ::Tell the user that this dialog is to log in. | ::"Please log in". |
|
| ::--Prompt | ::Tell the user that this dialog is to log in. | ::"Please log in". |
|
||||||
| ::--Message area | ::Give the user some feedback about the login process. | ::Initially blank. Changes to "Checking username and password" when the user presses "Login". Changes to "Invalid username or password, please try again", if login fails. |
|
| ::--Message area | ::Give the user some feedback about the login process. | ::Initially blank. Changes to "Checking username and password" when the user presses "Login". Changes to "Invalid username or password, please try again", if login fails. |
|
||||||
| ::--Username | ::Identify the user account that the current user is trying to access. | ::The name of the user account. Regex: [-_a-z0-9]{1-16}. The application should not do anything that would help users guess usernames. E.g., this should not be a combo-box with recent users listed, and it should not offer auto-complete. |
|
| ::--Username | ::Identify the user account that the current user is trying to access. | ::The name of the user account. Regex: [-_a-z0-9]{1-16}. The application should not do anything that would help users guess usernames. E.g., this should not be a combo-box with recent users listed, and it should not offer auto-complete. |
|
||||||
| ::--Password | ::Verify that the current user knows a secret password that only the true user of that user account should know. | ::The password of 4-16 characters. Do not display the password on the screen. The application should not do anything that would help users guess passwords. |
|
| ::--Password | ::Verify that the current user knows a secret password that only the true user of that user account should know. | ::The password of 4-16 characters. Do not display the password on the screen. The application should not do anything that would help users guess passwords. |
|
||||||
| ::--Login | ::Allow the user to indicate that they have completed entry of their username and password. | ::"Login" Only enabled when Username != "". If the username or password is incorrect, delay a few seconds, and then clear all fields. |
|
| ::--Login | ::Allow the user to indicate that they have completed entry of their username and password. | ::"Login" Only enabled when Username != "". If the username or password is incorrect, delay a few seconds, and then clear all fields. |
|
||||||
| ::--Lost Password | ::Allow the current user to start a process of generating a new password for a given username. | ::"Forgot your password? Click here." Only enabled when Username != "". |
|
| ::--Lost Password | ::Allow the current user to start a process of generating a new password for a given username. | ::"Forgot your password? Click here." Only enabled when Username != "". |
|
||||||
| ::[PAGE-NAME](LINK-TO-MOCKUP) | ::PURPOSE | |
|
| ::[PAGE-NAME](LINK-TO-MOCKUP) | ::PURPOSE | |
|
||||||
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
||||||
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
||||||
| ::[PAGE-NAME](LINK-TO-MOCKUP) | ::PURPOSE | |
|
| ::[PAGE-NAME](LINK-TO-MOCKUP) | ::PURPOSE | |
|
||||||
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
||||||
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
||||||
| ::[MAIN-WINDOW-NAME](LINK-TO-MOCKUP) | ::PURPOSE | |
|
| ::[MAIN-WINDOW-NAME](LINK-TO-MOCKUP) | ::PURPOSE | |
|
||||||
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
||||||
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
||||||
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
||||||
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
||||||
| ::[DIALOG-NAME](LINK-TO-MOCKUP) | ::PURPOSE | |
|
| ::[DIALOG-NAME](LINK-TO-MOCKUP) | ::PURPOSE | |
|
||||||
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
||||||
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
||||||
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
||||||
| ::[DIALOG-NAME](LINK-TO-MOCKUP) | ::PURPOSE | |
|
| ::[DIALOG-NAME](LINK-TO-MOCKUP) | ::PURPOSE | |
|
||||||
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
||||||
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
||||||
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
| ::--ABSTRACT-COMPONENT-NAME | ::PURPOSE | ::CONTENTS |
|
||||||
|
|
||||||
### Technical Constraints / Operational Context
|
### Technical Constraints / Operational Context
|
||||||
|
|
||||||
|
|
||||||
#### What are your assumptions about the output devices?
|
#### What are your assumptions about the output devices?
|
||||||
|
|
||||||
::We assume that the user has a 17-inch or larger screen with 1024x768
|
::We assume that the user has a 17-inch or larger screen with 1024x768
|
||||||
@ -159,7 +161,6 @@ may add or remove questions to fit your project.*
|
|||||||
|
|
||||||
#### Understandability and learnability
|
#### Understandability and learnability
|
||||||
|
|
||||||
|
|
||||||
##### Are there any labels of icons that are likely to be misunderstood?
|
##### Are there any labels of icons that are likely to be misunderstood?
|
||||||
|
|
||||||
::1-3 SENTENCES
|
::1-3 SENTENCES
|
||||||
@ -169,6 +170,7 @@ may add or remove questions to fit your project.*
|
|||||||
::1-3 SENTENCES
|
::1-3 SENTENCES
|
||||||
|
|
||||||
##### Are advanced options clearly separated from the most commonly used options?
|
##### Are advanced options clearly separated from the most commonly used options?
|
||||||
|
|
||||||
::1-3 SENTENCES
|
::1-3 SENTENCES
|
||||||
|
|
||||||
##### Are there no invisible options or commands? E.g., hold down the control key when opening a dialog box to see advanced options.
|
##### Are there no invisible options or commands? E.g., hold down the control key when opening a dialog box to see advanced options.
|
||||||
@ -177,7 +179,6 @@ may add or remove questions to fit your project.*
|
|||||||
|
|
||||||
#### Task Support and Efficiency
|
#### Task Support and Efficiency
|
||||||
|
|
||||||
|
|
||||||
##### Which use cases force the user to work through more than two interaction contexts?
|
##### Which use cases force the user to work through more than two interaction contexts?
|
||||||
|
|
||||||
::1-3 SENTENCES
|
::1-3 SENTENCES
|
||||||
@ -188,7 +189,6 @@ may add or remove questions to fit your project.*
|
|||||||
|
|
||||||
#### Safety
|
#### Safety
|
||||||
|
|
||||||
|
|
||||||
##### Are there any dangerous or irreversible actions that are done with only one step?
|
##### Are there any dangerous or irreversible actions that are done with only one step?
|
||||||
|
|
||||||
::1-3 SENTENCES
|
::1-3 SENTENCES
|
||||||
@ -203,14 +203,10 @@ may add or remove questions to fit your project.*
|
|||||||
|
|
||||||
::1-3 SENTENCES
|
::1-3 SENTENCES
|
||||||
|
|
||||||
##### Do all elements in your system that appear the same, actually function the same?
|
|
||||||
|
|
||||||
::1-3 SENTENCES
|
|
||||||
|
|
||||||
##### Are all elements share consistent visual characteristics such as font and color scheme, unless there is a reason for them to differ?
|
##### Are all elements share consistent visual characteristics such as font and color scheme, unless there is a reason for them to differ?
|
||||||
|
|
||||||
::1-3 SENTENCES
|
::1-3 SENTENCES
|
||||||
|
|
||||||
#####Are labels used consistently throughout the system? E.g., not "forward/back" in some contexts and "next/prev" in others.
|
##### Are labels used consistently throughout the system? E.g., not "forward/back" in some contexts and "next/prev" in others.
|
||||||
|
|
||||||
::1-3 SENTENCES
|
::1-3 SENTENCES
|
||||||
|
109
Design.md
109
Design.md
@ -1,74 +1,79 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
|
||||||
|
|
||||||
##### Internal Release Number:
|
::[PROJECT-NAME](Home)
|
||||||
::X.Y.Z
|
|
||||||
|
##### Internal Release Number
|
||||||
|
|
||||||
|
::X.Y.Z
|
||||||
|
|
||||||
|
##### Attached Worksheets
|
||||||
|
|
||||||
##### Attached Worksheets:
|
|
||||||
- Design > [Architecture Worksheet](Design-Architecture)
|
- Design > [Architecture Worksheet](Design-Architecture)
|
||||||
- Design > [Source Organization and Build Worksheet] > (Design-Src-Org)
|
- Design > [Source Organization and Build Worksheet](Design-Src-Org)
|
||||||
<!-- - Design > [Scalability Worksheet](Design-Scalability) -->
|
- Design > [Scalability Worksheet](Design-Scalability)
|
||||||
- Design > [User Interface Worksheet](Design-UI)
|
- Design > [User Interface Worksheet](Design-UI)
|
||||||
- Design > [Persistent Storage Worksheet](Design-Persistence)
|
- Design > [Persistent Storage Worksheet](Design-Persistence)
|
||||||
- Design > [Security Worksheet](Design-Security)
|
- Design > [Security Worksheet](Design-Security)
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
|
|
||||||
- [SRS](SRS) > [Use case suite](Use-Case-Suite)
|
- [SRS](SRS) > [Use case suite](Use-Case-Suite)
|
||||||
- [SRS](SRS) > [Feature set](Feature-Set)
|
- [SRS](SRS) > [Feature set](Feature-Set)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
- ::LINKS TO OTHER DOCUMENTS
|
- ::LINKS TO OTHER DOCUMENTS
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**Process impact:** This design document describes a system that will
|
**Process impact:**
|
||||||
satisfy the requirements of the [SRS](SRS). Decisions made in
|
|
||||||
creating this design document are based on those requirements and an
|
|
||||||
understanding of available technologies and components. Once the design
|
|
||||||
has been drafted, work on the system implementation and unit testing may
|
|
||||||
begin.
|
|
||||||
|
|
||||||
*TODO: Fill in the sections below. Add ore remove items as needed for
|
This design document describes a system that will satisfy the requirements of the [SRS](SRS). Decisions made in creating this design document are based on those requirements and an understanding of available technologies and components. Once the design has been drafted, work on the system implementation and unit testing may begin.
|
||||||
your project.*
|
|
||||||
|
*TODO: Fill in the sections below. Add ore remove items as needed for your project.*
|
||||||
|
|
||||||
### Introduction
|
### Introduction
|
||||||
|
|
||||||
#### How is this design document organized?
|
#### How is this design document organized?
|
||||||
|
|
||||||
This main page describes the system design in terms of packages,
|
This main page describes the system design in terms of packages,
|
||||||
classes, relationships, and behavior. Several attached worksheets
|
classes, relationships, and behavior. Several attached worksheets
|
||||||
address specific aspects of the overall system design, such as user
|
address specific aspects of the overall system design, such as user
|
||||||
interface and database design.
|
interface and database design.
|
||||||
|
|
||||||
#### What are the most important facts that a developer should know about this design?
|
#### What are the most important facts that a developer should know about this design?
|
||||||
|
|
||||||
::PARAGRAPH or BULLETS
|
::PARAGRAPH or BULLETS
|
||||||
|
|
||||||
#### What are the prioritized goals of this design?
|
#### What are the prioritized goals of this design?
|
||||||
1. ::[Correctness](Glossary-Standard-Terms#dg_correctness)
|
|
||||||
2. ::[Feasibility](Glossary-Standard-Terms#dg_feasibility)
|
1. ::[Correctness](Glossary-Standard-Terms#correctness)
|
||||||
3. ::[Understandability](Glossary-Standard-Terms#dg_understandability)
|
2. ::[Feasibility](Glossary-Standard-Terms#feasibility)
|
||||||
4. ::[Implementation phase guidance](Glossary-Standard-Terms#dg_guidance)
|
3. ::[Understandability](Glossary-Standard-Terms#understandability)
|
||||||
5. ::[Modularity](Glossary-Standard-Terms#dg_modularity)
|
4. ::[Implementation phase guidance](Glossary-Standard-Terms#implementation-and-phase-guidance)
|
||||||
6. ::[Extensibility](Glossary-Standard-Terms#dg_extensibility)
|
5. ::[Modularity](Glossary-Standard-Terms#modularity)
|
||||||
7. ::[Testability](Glossary-Standard-Terms#dg_testability)
|
6. ::[Extensibility](Glossary-Standard-Terms#extensibility)
|
||||||
8. ::[Efficiency](Glossary-Standard-Terms#dg_efficiency)
|
7. ::[Testability](Glossary-Standard-Terms#testability)
|
||||||
|
8. ::[Efficiency](Glossary-Standard-Terms#efficiency)
|
||||||
|
|
||||||
### UML Structural Design
|
### UML Structural Design
|
||||||
|
|
||||||
*TODO: Link to a design model and/or design diagrams that describe your
|
*TODO: Link to a design model and/or design diagrams that describe your
|
||||||
system's structure in detail.*
|
system's structure in detail.*
|
||||||
|
|
||||||
#### The system's structural design is described in the following UML model:
|
#### The system's structural design is described in the following UML model
|
||||||
::[MODELNAME](LINK-TO-MODEL-FILE).
|
|
||||||
|
|
||||||
#### The system's structural design is described in the following UML structural diagrams:
|
::[MODEL-NAME](LINK-TO-MODEL-FILE).
|
||||||
|
|
||||||
|
#### The system's structural design is described in the following UML structural diagrams
|
||||||
|
|
||||||
- ::[PACKAGE OVERVIEW DIAGRAM](LINK-TO-DIAGRAM)
|
- ::[PACKAGE OVERVIEW DIAGRAM](LINK-TO-DIAGRAM)
|
||||||
- ::PACKAGENAME
|
- ::PACKAGE-NAME
|
||||||
- ::[DIAGRAMNAME](LINK-TO-DIAGRAM)
|
- ::[DIAGRAM-NAME](LINK-TO-DIAGRAM)
|
||||||
- ::[DIAGRAMNAME](LINK-TO-DIAGRAM)
|
- ::[DIAGRAM-NAME](LINK-TO-DIAGRAM)
|
||||||
- ::PACKAGENAME
|
- ::PACKAGE-NAME
|
||||||
- ::[DIAGRAMNAME](LINK-TO-DIAGRAM)
|
- ::[DIAGRAM-NAME](LINK-TO-DIAGRAM)
|
||||||
- ::PACKAGENAME
|
- ::PACKAGE-NAME
|
||||||
- ::[DIAGRAMNAME](LINK-TO-DIAGRAM)
|
- ::[DIAGRAM-NAME](LINK-TO-DIAGRAM)
|
||||||
|
|
||||||
::ANY ADDITIONAL NOTES OR COMMENTS
|
::ANY ADDITIONAL NOTES OR COMMENTS
|
||||||
|
|
||||||
@ -77,23 +82,24 @@ system's structure in detail.*
|
|||||||
*TODO: Link to a design model and/or design diagrams that describe your
|
*TODO: Link to a design model and/or design diagrams that describe your
|
||||||
system's behavior in detail.*
|
system's behavior in detail.*
|
||||||
|
|
||||||
#### The system's behavioral design is described in the following UML model:
|
#### The system's behavioral design is described in the following UML model
|
||||||
::[MODELNAME](LINK-TO-MODEL-FILE)
|
|
||||||
|
|
||||||
#### The system's behavioral design is described in the following UML behavioral diagrams:
|
::[MODEL-NAME](LINK-TO-MODEL-FILE)
|
||||||
|
|
||||||
|
#### The system's behavioral design is described in the following UML behavioral diagrams
|
||||||
|
|
||||||
- State Diagrams
|
- State Diagrams
|
||||||
- ::[DIAGRAMNAME](LINK-TO-DIAGRAM)
|
- ::[DIAGRAM-NAME](LINK-TO-DIAGRAM)
|
||||||
- ::[DIAGRAMNAME](LINK-TO-DIAGRAM)
|
- ::[DIAGRAM-NAME](LINK-TO-DIAGRAM)
|
||||||
- Sequence Diagrams
|
- Sequence Diagrams
|
||||||
- ::[DIAGRAMNAME](LINK-TO-DIAGRAM)
|
- ::[DIAGRAM-NAME](LINK-TO-DIAGRAM)
|
||||||
- ::[DIAGRAMNAME](LINK-TO-DIAGRAM)
|
- ::[DIAGRAM-NAME](LINK-TO-DIAGRAM)
|
||||||
- ::[DIAGRAMNAME](LINK-TO-DIAGRAM)
|
- ::[DIAGRAM-NAME](LINK-TO-DIAGRAM)
|
||||||
- ::[DIAGRAMNAME](LINK-TO-DIAGRAM)
|
- ::[DIAGRAM-NAME](LINK-TO-DIAGRAM)
|
||||||
- ::[DIAGRAMNAME](LINK-TO-DIAGRAM)
|
- ::[DIAGRAM-NAME](LINK-TO-DIAGRAM)
|
||||||
- Collaboration Diagrams
|
- Collaboration Diagrams
|
||||||
- ::[DIAGRAMNAME](LINK-TO-DIAGRAM)
|
- ::[DIAGRAM-NAME](LINK-TO-DIAGRAM)
|
||||||
- ::[DIAGRAMNAME](LINK-TO-DIAGRAM)
|
- ::[DIAGRAM-NAME](LINK-TO-DIAGRAM)
|
||||||
|
|
||||||
::ANY ADDITIONAL NOTES OR COMMENTS
|
::ANY ADDITIONAL NOTES OR COMMENTS
|
||||||
|
|
||||||
@ -105,30 +111,39 @@ positively, that may indicate an aspect of the design that should be
|
|||||||
revised.*
|
revised.*
|
||||||
|
|
||||||
#### Correctness: How do you know that this design is correct?
|
#### Correctness: How do you know that this design is correct?
|
||||||
|
|
||||||
::2-4 SENTENCES
|
::2-4 SENTENCES
|
||||||
|
|
||||||
#### Feasibility: What indicates that this design can be implemented and tested with the planned amount of time and effort?
|
#### Feasibility: What indicates that this design can be implemented and tested with the planned amount of time and effort?
|
||||||
|
|
||||||
::2-4 SENTENCES
|
::2-4 SENTENCES
|
||||||
|
|
||||||
#### Understandability: What makes this design understandable?
|
#### Understandability: What makes this design understandable?
|
||||||
|
|
||||||
::2-4 SENTENCES
|
::2-4 SENTENCES
|
||||||
|
|
||||||
#### Implementation phase guidance: Does the design suggest reasonable implementation tasks?
|
#### Implementation phase guidance: Does the design suggest reasonable implementation tasks?
|
||||||
|
|
||||||
::2-4 SENTENCES
|
::2-4 SENTENCES
|
||||||
|
|
||||||
#### Modularity: How have concerns been separated and addressed in distinct modules?
|
#### Modularity: How have concerns been separated and addressed in distinct modules?
|
||||||
|
|
||||||
::2-4 SENTENCES
|
::2-4 SENTENCES
|
||||||
|
|
||||||
#### Extensibility: How can new features can be easily added later?
|
#### Extensibility: How can new features can be easily added later?
|
||||||
|
|
||||||
::2-4 SENTENCES
|
::2-4 SENTENCES
|
||||||
|
|
||||||
#### Testability: What makes this system easy to test?
|
#### Testability: What makes this system easy to test?
|
||||||
|
|
||||||
::2-4 SENTENCES
|
::2-4 SENTENCES
|
||||||
|
|
||||||
#### Efficiency: Does the system consume an acceptable amount of time, storage space, bandwidth, and other resources?
|
#### Efficiency: Does the system consume an acceptable amount of time, storage space, bandwidth, and other resources?
|
||||||
|
|
||||||
::2-4 SENTENCES
|
::2-4 SENTENCES
|
||||||
|
|
||||||
#### Has the design been communicated to the development team and other stakeholders?
|
#### Has the design been communicated to the development team and other stakeholders?
|
||||||
|
|
||||||
- ::Yes, everyone understands. Feedback is welcome.
|
- ::Yes, everyone understands. Feedback is welcome.
|
||||||
- ::No, this is a risk that is noted in the
|
- ::No, this is a risk that is noted in the
|
||||||
[Risk Management](Project-Plan#Risk-Management) section.
|
[Risk Management](Project-Plan#Risk-Management) section.
|
||||||
|
@ -1,8 +1,8 @@
|
|||||||
*TODO: This template is not done yet. Feel free to contribute your ideas.*
|
*TODO: This template is not done yet. Feel free to contribute your ideas.*
|
||||||
|
|
||||||
This document defines the artifacts the team creates during your software
|
This document defines the artifacts the team creates during your software
|
||||||
development process. Documenting artifact types helps define the inputs and
|
development process. Documenting artifact types helps define the inputs and
|
||||||
outputs of each development task. The producer/consumer matrix helps document
|
outputs of each development task. The producer/consumer matrix helps document
|
||||||
the software development workflow.
|
the software development workflow.
|
||||||
|
|
||||||
### Artifact Producer / Consumer Matrix
|
### Artifact Producer / Consumer Matrix
|
||||||
|
23
FAQ.md
23
FAQ.md
@ -8,24 +8,23 @@ contributors, members of a developers' network, or administrators.*
|
|||||||
|
|
||||||
### General Information
|
### General Information
|
||||||
|
|
||||||
#### What is ::PRODUCTNAME?
|
#### What is ::PRODUCT-NAME?
|
||||||
|
|
||||||
::It is a XXXXX. Read our [PRODUCTNAME overview](http://www.COMPANY.com/products/PRODUCTNAME/).
|
::It is a XXXXX. Read our [PRODUCT-NAME overview](http://www.COMPANY.com/products/PRODUCT-NAME/).
|
||||||
|
|
||||||
#### Who should use ::PRODUCTNAME?
|
#### Who should use ::PRODUCT-NAME?
|
||||||
|
|
||||||
::Anyone who wants XXXXXXX. Read more about our [target audience and
|
::Anyone who wants XXXXXXX. Read more about our [target audience and benefits](Target-and-Benefits).
|
||||||
benefits](Target-and-Benefits).
|
|
||||||
|
|
||||||
### Download and Install
|
### Download and Install
|
||||||
|
|
||||||
#### How can I obtain ::PRODUCTNAME?
|
#### How can I obtain ::PRODUCT-NAME?
|
||||||
|
|
||||||
::You may [download PRODUCTNAME](LINK-TO-DOWNLOAD).
|
::You may [download PRODUCT-NAME](LINK-TO-DOWNLOAD).
|
||||||
|
|
||||||
::You may [place an order for PRODUCTNAME](LINK-TO-ORDER).
|
::You may [place an order for PRODUCT-NAME](LINK-TO-ORDER).
|
||||||
|
|
||||||
#### What do I need to use ::PRODUCTNAME?
|
#### What do I need to use ::PRODUCT-NAME?
|
||||||
|
|
||||||
::System requirements are described in the [release notes](Release-Notes).
|
::System requirements are described in the [release notes](Release-Notes).
|
||||||
|
|
||||||
@ -34,11 +33,11 @@ of at least XXX MHz, XXX MB of RAM. XXX MB of free disk space, and
|
|||||||
one of the following operating systems: Windows 98/2000/XP, Mac
|
one of the following operating systems: Windows 98/2000/XP, Mac
|
||||||
OSX, Linux.
|
OSX, Linux.
|
||||||
|
|
||||||
#### How do I install ::PRODUCTNAME?
|
#### How do I install ::PRODUCT-NAME?
|
||||||
|
|
||||||
::[Installation instructions](install.html) are available on-line.
|
::[Installation instructions](install.html) are available on-line.
|
||||||
|
|
||||||
#### How do I upgrade from an older version of PRODUCTNAME?
|
#### How do I upgrade from an older version of PRODUCT-NAME?
|
||||||
|
|
||||||
::[Installation instructions](install.html) are available on-line.
|
::[Installation instructions](install.html) are available on-line.
|
||||||
|
|
||||||
@ -56,7 +55,7 @@ OSX, Linux.
|
|||||||
#### How do I do ::COMMON-TASK?
|
#### How do I do ::COMMON-TASK?
|
||||||
|
|
||||||
::You should understand that XXX. Once you are ready, you can:
|
::You should understand that XXX. Once you are ready, you can:
|
||||||
|
|
||||||
1. ::Step one
|
1. ::Step one
|
||||||
2. ::Step two
|
2. ::Step two
|
||||||
3. ::Step three
|
3. ::Step three
|
||||||
|
@ -1,11 +1,15 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
|
||||||
|
|
||||||
##### Internal Release Number:
|
::[PROJECT-NAME](Home)
|
||||||
::X.Y.Z
|
|
||||||
|
##### Internal Release Number
|
||||||
|
|
||||||
|
::X.Y.Z
|
||||||
|
|
||||||
|
##### Related Documents
|
||||||
|
|
||||||
##### Related Documents:
|
|
||||||
- [SRS](SRS) > [Feature Set](Feature-Set) > Feature Specification Format
|
- [SRS](SRS) > [Feature Set](Feature-Set) > Feature Specification Format
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**Process impact:** This reference page documents the format of feature
|
**Process impact:** This reference page documents the format of feature
|
||||||
@ -18,6 +22,7 @@ features.
|
|||||||
as needed in your [Features](Features) document.*
|
as needed in your [Features](Features) document.*
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-00: FEATURE NAME
|
### ::F-00: FEATURE NAME
|
||||||
|
|
||||||
Priority: ::Essential | Expected | Desired | Optional
|
Priority: ::Essential | Expected | Desired | Optional
|
||||||
@ -35,7 +40,7 @@ Description:
|
|||||||
::1-4 PARAGRAPHS. USE BULLETS OR TABLES TO ORGANIZE INFORMATION. LINK TO WORKSHEETS OR ADDITIONAL INFORMATION.
|
::1-4 PARAGRAPHS. USE BULLETS OR TABLES TO ORGANIZE INFORMATION. LINK TO WORKSHEETS OR ADDITIONAL INFORMATION.
|
||||||
|
|
||||||
Precise Details:
|
Precise Details:
|
||||||
|
|
||||||
- ::LOGICAL CONSTRAINT
|
- ::LOGICAL CONSTRAINT
|
||||||
- ::LOGICAL CONSTRAINT
|
- ::LOGICAL CONSTRAINT
|
||||||
|
|
||||||
@ -47,6 +52,7 @@ Notes and Questions:
|
|||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Feature Attribute Values
|
### Feature Attribute Values
|
||||||
|
|
||||||
- Priority
|
- Priority
|
||||||
@ -54,10 +60,10 @@ Notes and Questions:
|
|||||||
this feature. It would be much harder to test, document, or
|
this feature. It would be much harder to test, document, or
|
||||||
package the product without this feature.
|
package the product without this feature.
|
||||||
- Expected: Key stakeholders strongly desire and expect
|
- Expected: Key stakeholders strongly desire and expect
|
||||||
this feature. It may have been promised to them in a certain
|
this feature. It may have been promiDIAGRAMsed to them in a certain
|
||||||
release. It's absence would substantially reduce the success of
|
release. It's absence would substantDIAGRAMially reduce the success of
|
||||||
the project.
|
the project.DIAGRAM
|
||||||
- Desired: Stakeholders desire this feature. It's absence would
|
- Desired: Stakeholders desire this feDIAGRAMature. It's absence would
|
||||||
reduce the success of the project.
|
reduce the success of the project.
|
||||||
- Optional: This feature would be nice to have. Adding it could
|
- Optional: This feature would be nice to have. Adding it could
|
||||||
have some advantage, but delaying it would not have a big effect
|
have some advantage, but delaying it would not have a big effect
|
||||||
|
@ -1,10 +1,13 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::PROJECTNAME
|
|
||||||
|
::PROJECT-NAME
|
||||||
|
|
||||||
|
##### Internal Release Number
|
||||||
|
|
||||||
##### Internal Release Number:
|
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
|
|
||||||
- [SRS](SRS) > Feature Set
|
- [SRS](SRS) > Feature Set
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [SRS](SRS) > [Use case suite](Use-Case-Suite)
|
- [SRS](SRS) > [Use case suite](Use-Case-Suite)
|
||||||
@ -12,6 +15,7 @@
|
|||||||
- ::LINK TO USE CASE DIAGRAM
|
- ::LINK TO USE CASE DIAGRAM
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
- ::LINKS TO OTHER DOCUMENTS
|
- ::LINKS TO OTHER DOCUMENTS
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**Process impact:** A feature set is simply a table of contents for the
|
**Process impact:** A feature set is simply a table of contents for the
|
||||||
@ -23,12 +27,12 @@ early.
|
|||||||
*TODO: Before writing individual feature descriptions, list all the
|
*TODO: Before writing individual feature descriptions, list all the
|
||||||
features that you think you will need. Organize them so that missing
|
features that you think you will need. Organize them so that missing
|
||||||
features appear as blanks on this page, and extra features will appear
|
features appear as blanks on this page, and extra features will appear
|
||||||
to be extras that don't fit anywhere. See the
|
to be extras that don't fit anywhere. See the
|
||||||
[feature format](Feature-Format#further-information) document for more
|
[feature format](Feature-Format#further-information) document for more
|
||||||
tips on specifying features and feature sets.*
|
tips on specifying features and feature sets.*
|
||||||
|
|
||||||
*TIP: Refer back to the user stories in your [user needs](User-Needs)
|
*TIP: Refer back to the user stories in your [user needs](User-Needs)
|
||||||
document and to the [use case suite](Use-Case-Suite).
|
document and to the [use case suite](Use-Case-Suite).
|
||||||
Use them for ideas and make sure that you cover all of them.*
|
Use them for ideas and make sure that you cover all of them.*
|
||||||
|
|
||||||
### Features by Release and Priority
|
### Features by Release and Priority
|
||||||
|
41
Features.md
41
Features.md
@ -1,16 +1,20 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::PROJECTNAME
|
|
||||||
|
::PROJECT-NAME
|
||||||
|
|
||||||
|
##### Internal Release Number
|
||||||
|
|
||||||
##### Internal Release Number:
|
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
|
|
||||||
- [SRS](SRS) > [Feature Set](Feature-Set) > Features
|
- [SRS](SRS) > [Feature Set](Feature-Set) > Features
|
||||||
- [Feature format](Feature-Format)
|
- [Feature format](Feature-Format)
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [SRS](SRS) > [Use case suite](Use-Case-Suite)
|
- [SRS](SRS) > [Use case suite](Use-Case-Suite)
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
- ::LINKS TO OTHER DOCUMENTS
|
- ::LINKS TO OTHER DOCUMENTS
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**Process impact:** This is a set of detailed feature descriptions.
|
**Process impact:** This is a set of detailed feature descriptions.
|
||||||
@ -34,6 +38,7 @@ unambiguous. E.g.,*
|
|||||||
- *Specify sequences of events with scenario diagrams*
|
- *Specify sequences of events with scenario diagrams*
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-00: Site Configuration
|
### ::F-00: Site Configuration
|
||||||
|
|
||||||
Priority: ::Essential
|
Priority: ::Essential
|
||||||
@ -55,11 +60,14 @@ Description:
|
|||||||
- ::The email address to be used to send critical error reports
|
- ::The email address to be used to send critical error reports
|
||||||
|
|
||||||
Notes and Questions:
|
Notes and Questions:
|
||||||
|
|
||||||
- ::NOTE
|
- ::NOTE
|
||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-01: User registration
|
### ::F-01: User registration
|
||||||
|
|
||||||
Priority: **::Essential**
|
Priority: **::Essential**
|
||||||
|
|
||||||
Effort: ::Days
|
Effort: ::Days
|
||||||
@ -93,6 +101,7 @@ Notes and Questions:
|
|||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-02: FEATURE NAME
|
### ::F-02: FEATURE NAME
|
||||||
|
|
||||||
Priority: ::Essential | Expected | Desired | Optional
|
Priority: ::Essential | Expected | Desired | Optional
|
||||||
@ -106,7 +115,7 @@ Functional area(s): ::WORD, WORD, WORD
|
|||||||
Use case(s): ::[UC-01](Use-Cases#UC-01)
|
Use case(s): ::[UC-01](Use-Cases#UC-01)
|
||||||
|
|
||||||
Description:
|
Description:
|
||||||
:: 1-4 PARAGRAPHS. USE BULLETS OR TABLES TO ORGANIZE INFORMATION. LINK TO WORKSHEETS OR ADDITIONAL INFORMATION.
|
:: 1-4 PARAGRAPHS. USE BULLETS OR TABLES TO ORGANIZE INFORMATION. LINK TO WORKSHEETS OR ADDITIONAL INFORMATION.
|
||||||
|
|
||||||
Precise Details:
|
Precise Details:
|
||||||
|
|
||||||
@ -119,6 +128,7 @@ Notes and Questions:
|
|||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-03: FEATURE NAME
|
### ::F-03: FEATURE NAME
|
||||||
|
|
||||||
Priority: ::Essential | Expected | Desired | Optional
|
Priority: ::Essential | Expected | Desired | Optional
|
||||||
@ -146,6 +156,7 @@ Notes and Questions:
|
|||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-10: FEATURE NAME
|
### ::F-10: FEATURE NAME
|
||||||
|
|
||||||
Priority: ::Essential | Expected | Desired | Optional
|
Priority: ::Essential | Expected | Desired | Optional
|
||||||
@ -172,8 +183,8 @@ Notes and Questions:
|
|||||||
- ::NOTE
|
- ::NOTE
|
||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-11: FEATURE NAME
|
### ::F-11: FEATURE NAME
|
||||||
|
|
||||||
Priority: ::Essential | Expected | Desired | Optional
|
Priority: ::Essential | Expected | Desired | Optional
|
||||||
@ -200,8 +211,8 @@ Notes and Questions:
|
|||||||
- ::NOTE
|
- ::NOTE
|
||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-12: FEATURE NAME
|
### ::F-12: FEATURE NAME
|
||||||
|
|
||||||
Priority: ::Essential | Expected | Desired | Optional
|
Priority: ::Essential | Expected | Desired | Optional
|
||||||
@ -229,6 +240,7 @@ Notes and Questions:
|
|||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-13: FEATURE NAME
|
### ::F-13: FEATURE NAME
|
||||||
|
|
||||||
Priority: ::Essential | Expected | Desired | Optional
|
Priority: ::Essential | Expected | Desired | Optional
|
||||||
@ -255,8 +267,8 @@ Notes and Questions:
|
|||||||
- ::NOTE
|
- ::NOTE
|
||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-20: FEATURE NAME
|
### ::F-20: FEATURE NAME
|
||||||
|
|
||||||
Priority: ::Essential | Expected | Desired | Optional
|
Priority: ::Essential | Expected | Desired | Optional
|
||||||
@ -283,8 +295,8 @@ Notes and Questions:
|
|||||||
- ::NOTE
|
- ::NOTE
|
||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-21: FEATURE NAME
|
### ::F-21: FEATURE NAME
|
||||||
|
|
||||||
Priority: ::Essential | Expected | Desired | Optional
|
Priority: ::Essential | Expected | Desired | Optional
|
||||||
@ -311,8 +323,8 @@ Notes and Questions:
|
|||||||
- ::NOTE
|
- ::NOTE
|
||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-22: FEATURE NAME
|
### ::F-22: FEATURE NAME
|
||||||
|
|
||||||
Priority: ::Essential | Expected | Desired | Optional
|
Priority: ::Essential | Expected | Desired | Optional
|
||||||
@ -339,8 +351,8 @@ Notes and Questions:
|
|||||||
- ::NOTE
|
- ::NOTE
|
||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-23: FEATURE NAME
|
### ::F-23: FEATURE NAME
|
||||||
|
|
||||||
Priority: ::Essential | Expected | Desired | Optional
|
Priority: ::Essential | Expected | Desired | Optional
|
||||||
@ -368,6 +380,7 @@ Notes and Questions:
|
|||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-30: FEATURE NAME
|
### ::F-30: FEATURE NAME
|
||||||
|
|
||||||
Priority: ::Essential | Expected | Desired | Optional
|
Priority: ::Essential | Expected | Desired | Optional
|
||||||
@ -394,8 +407,8 @@ Notes and Questions:
|
|||||||
- ::NOTE
|
- ::NOTE
|
||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-31: FEATURE NAME
|
### ::F-31: FEATURE NAME
|
||||||
|
|
||||||
Priority: ::Essential | Expected | Desired | Optional
|
Priority: ::Essential | Expected | Desired | Optional
|
||||||
@ -422,8 +435,8 @@ Notes and Questions:
|
|||||||
- ::NOTE
|
- ::NOTE
|
||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-32: FEATURE NAME
|
### ::F-32: FEATURE NAME
|
||||||
|
|
||||||
Priority: ::Essential | Expected | Desired | Optional
|
Priority: ::Essential | Expected | Desired | Optional
|
||||||
@ -450,8 +463,8 @@ Notes and Questions:
|
|||||||
- ::NOTE
|
- ::NOTE
|
||||||
- ::QUESTION
|
- ::QUESTION
|
||||||
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### ::F-33: FEATURE NAME
|
### ::F-33: FEATURE NAME
|
||||||
|
|
||||||
Priority: ::Essential | Expected | Desired | Optional
|
Priority: ::Essential | Expected | Desired | Optional
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
|
|
||||||
|
|
||||||
# Standard Terms Glossary
|
# Standard Terms Glossary
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**Process impact:** This file as a dictionary of standard terms defined
|
**Process impact:** This file as a dictionary of standard terms defined
|
||||||
@ -10,19 +10,12 @@ helps keep other documents more concise and easy to edit. Check the
|
|||||||
[ReadySET glossary](http://readyset.tigris.org/templates/glossary-std.html) for
|
[ReadySET glossary](http://readyset.tigris.org/templates/glossary-std.html) for
|
||||||
updates.
|
updates.
|
||||||
|
|
||||||
Jump to: [General](#general-terms) |
|
Jump to: [General](#general-terms) | [Computer science & technology](#computer-science-and-technology-terms) | [Process](#process-terms) | [Software development tools](#development-tool-terms) | [Requirements](#requirements-terms) | [Design](#design-terms) | [Design goals terms](#desigD-DIAGRAMn-goals-terms) | [QA terms](#qa-terms) | [QA goals terms](#qa-goals-terms) | [Additional terms](#additional-standard-terms)| [Project terms](Glossary)
|
||||||
[Computer science & technology](#computer-science-and-technology-terms) |
|
|
||||||
[Process](#process-terms) |
|
|
||||||
[Software development tools](#development-tool-terms) |
|
|
||||||
[Requirements](#requirements-terms) | [Design](#design-terms) |
|
|
||||||
[Design goals terms](#design-goals-terms) | [QA terms](#qa-terms) |
|
|
||||||
[QA goals terms](#qa-goals-terms) | [Additional terms](#additional-standard-terms)|
|
|
||||||
[Project terms](Glossary)
|
|
||||||
|
|
||||||
|
|
||||||
### General Terms
|
### General Terms
|
||||||
|
|
||||||
##### Chipping away
|
##### Chipping away
|
||||||
|
|
||||||
The process of removing sample text from templates when that text
|
The process of removing sample text from templates when that text
|
||||||
does not apply to the current project. Often some of the sample text
|
does not apply to the current project. Often some of the sample text
|
||||||
will be kept or revised to fit the current project. Even if the
|
will be kept or revised to fit the current project. Even if the
|
||||||
@ -33,23 +26,27 @@ he carved a marble statue of a horse, he replies "It was easy, I
|
|||||||
just started with a big block of marble and chipped away everything
|
just started with a big block of marble and chipped away everything
|
||||||
that did not look like a horse."
|
that did not look like a horse."
|
||||||
|
|
||||||
##### Attached worksheet
|
##### Attached worksheetD-DIAGRAM
|
||||||
The idea is similar to filling in an IRS form and using worksheets
|
|
||||||
to calculate subtotals or make specific decisions. That is to say,
|
|
||||||
there is a hierarchy to the templates: there are the main templates,
|
|
||||||
and then worksheets for specific topics. We have divided the
|
|
||||||
information into several files so that each file is focused on one
|
|
||||||
topic, and so that each file can be worked on by one person in a
|
|
||||||
reasonable amount of time.
|
|
||||||
|
|
||||||
##### Process impact
|
The idea is similar to fillD-DIAGRAMing in an IRS form and using worksheets
|
||||||
The process impact box on each template explains where the current
|
to calculate subtotals or mD-DIAGRAMake specific decisions. That is to say,
|
||||||
template fits into the software development process. It usually
|
there is a hierarchy to theD-DIAGRAM templates: there are the main templates,
|
||||||
|
and then worksheets for speD-DIAGRAMcific topics. We have divided the
|
||||||
|
information into several fiD-DIAGRAMles so that each file is focused on one
|
||||||
|
topic, and so that each filD-DIAGRAMe can be worked on by one person in a
|
||||||
|
reasonable amount of time.D-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
|
|
||||||
|
##### Process impactD-DIAGRAM
|
||||||
|
|
||||||
|
The process impact box on eD-DIAGRAMach template explains where the current
|
||||||
|
template fits into the softD-DIAGRAMware development process. It usually
|
||||||
includes a brief comment on who should create the document, and who
|
includes a brief comment on who should create the document, and who
|
||||||
would be expected to make use of it. You can change the process
|
would be expected to make use of it. You can change the process
|
||||||
impact box, but you should not need to.
|
impact box, but you should not need to.
|
||||||
|
|
||||||
##### Checklist
|
##### Checklist
|
||||||
|
|
||||||
There are two kinds of checklists:
|
There are two kinds of checklists:
|
||||||
|
|
||||||
- Many of the templates have a section with questions that help
|
- Many of the templates have a section with questions that help
|
||||||
@ -60,6 +57,7 @@ There are two kinds of checklists:
|
|||||||
in those artifacts.
|
in those artifacts.
|
||||||
|
|
||||||
##### Sticky note
|
##### Sticky note
|
||||||
|
|
||||||
The idea is similar to a post-it note attached to a document that
|
The idea is similar to a post-it note attached to a document that
|
||||||
tells you do "sign here" or fill in a certain part. There are two
|
tells you do "sign here" or fill in a certain part. There are two
|
||||||
types of sticky notes:
|
types of sticky notes:
|
||||||
@ -80,12 +78,14 @@ sticky note.
|
|||||||
### Computer Science and Technology Terms
|
### Computer Science and Technology Terms
|
||||||
|
|
||||||
##### ::API (Application Programming Interface)
|
##### ::API (Application Programming Interface)
|
||||||
|
|
||||||
An API is a set of functions that one software component makes
|
An API is a set of functions that one software component makes
|
||||||
available to other software components. That allows other programs
|
available to other software components. That allows other programs
|
||||||
to "call" this program via direct function calls, or more indirect
|
to "call" this program via direct function calls, or more indirect
|
||||||
communications such as [SOAP](#soap) messages.
|
communications such as [SOAP](#soap) messages.
|
||||||
|
|
||||||
##### ::SOAP
|
##### ::SOAP
|
||||||
|
|
||||||
SOAP (Simple Object Access Protocol) is the message format used by
|
SOAP (Simple Object Access Protocol) is the message format used by
|
||||||
standard web services. It entails sending an XML document to a
|
standard web services. It entails sending an XML document to a
|
||||||
server in order to invoke an operation on the server-side.
|
server in order to invoke an operation on the server-side.
|
||||||
@ -94,7 +94,8 @@ server in order to invoke an operation on the server-side.
|
|||||||
### Process Terms
|
### Process Terms
|
||||||
|
|
||||||
##### Change Control Board (CCB)
|
##### Change Control Board (CCB)
|
||||||
A group of people who review proposed changes to the project
|
|
||||||
|
A group of people who review proposed changes toD-DIAGRAM the project
|
||||||
requirements and/or source code to accept or reject changes in each
|
requirements and/or source code to accept or reject changes in each
|
||||||
particular release. Proposed changes are usually rejected if they
|
particular release. Proposed changes are usually rejected if they
|
||||||
introduce too much risk or would trigger additional effort (e.g.,
|
introduce too much risk or would trigger additional effort (e.g.,
|
||||||
@ -103,6 +104,7 @@ composed of managers and representatives of other stakeholders such
|
|||||||
as the QA group and key customers.
|
as the QA group and key customers.
|
||||||
|
|
||||||
##### Feature Complete
|
##### Feature Complete
|
||||||
|
|
||||||
A release is called "feature complete" when the development team
|
A release is called "feature complete" when the development team
|
||||||
agrees that no new features will be added to this release. New
|
agrees that no new features will be added to this release. New
|
||||||
features may still be suggested for later releases. More development
|
features may still be suggested for later releases. More development
|
||||||
@ -110,6 +112,7 @@ work needs to be done to implement all the features and
|
|||||||
repair defects.
|
repair defects.
|
||||||
|
|
||||||
##### Code Complete
|
##### Code Complete
|
||||||
|
|
||||||
A release is called "code complete" when the development team agrees
|
A release is called "code complete" when the development team agrees
|
||||||
that no entirely new source code will be added to this release.
|
that no entirely new source code will be added to this release.
|
||||||
There may still be source code changes to fix defects. There may
|
There may still be source code changes to fix defects. There may
|
||||||
@ -118,12 +121,14 @@ for test cases or utilities. New code may be added in a
|
|||||||
future release.
|
future release.
|
||||||
|
|
||||||
##### Internal Release Number
|
##### Internal Release Number
|
||||||
|
|
||||||
An internal release number is the number that the development team
|
An internal release number is the number that the development team
|
||||||
gives each release. Internal release numbers typically count up
|
gives each release. Internal release numbers typically count up
|
||||||
logically, i.e., they do not skip numbers. They may have many parts:
|
logically, i.e., they do not skip numbers. They may have many parts:
|
||||||
e.g., major, minor, patch-level, build number, RC number.
|
e.g., major, minor, patch-level, build number, RC number.
|
||||||
|
|
||||||
##### External Release Number
|
##### External Release Number
|
||||||
|
|
||||||
External release numbers are the numbers that users see. Often, they
|
External release numbers are the numbers that users see. Often, they
|
||||||
will be the same as the internal release number. That is especially
|
will be the same as the internal release number. That is especially
|
||||||
true if the product being built is a component intended to be reused
|
true if the product being built is a component intended to be reused
|
||||||
@ -136,6 +141,7 @@ version 8. Later, the competition used version "10 Optimized" rather
|
|||||||
than "10.1" or "11".
|
than "10.1" or "11".
|
||||||
|
|
||||||
##### Release Number
|
##### Release Number
|
||||||
|
|
||||||
The term "release number" by itself refers to an
|
The term "release number" by itself refers to an
|
||||||
[external release number](#external_release_number). Users normally are not aware
|
[external release number](#external_release_number). Users normally are not aware
|
||||||
of the existence of any internal release numbers.
|
of the existence of any internal release numbers.
|
||||||
@ -143,35 +149,41 @@ of the existence of any internal release numbers.
|
|||||||
### Development Tool Terms
|
### Development Tool Terms
|
||||||
|
|
||||||
#### Version Control System
|
#### Version Control System
|
||||||
|
|
||||||
::DEFINITION1
|
::DEFINITION1
|
||||||
|
|
||||||
#### Commit Log Message
|
#### Commit Log Message
|
||||||
|
|
||||||
::DEFINITION1
|
::DEFINITION1
|
||||||
|
|
||||||
#### Issue Tracker
|
#### Issue Tracker
|
||||||
|
|
||||||
::DEFINITION1
|
::DEFINITION1
|
||||||
|
|
||||||
#### Unit Testing Automation
|
#### Unit Testing Automation
|
||||||
|
|
||||||
::DEFINITION1
|
::DEFINITION1
|
||||||
|
|
||||||
#### Automated Build System
|
#### Automated Build System
|
||||||
::DEFINITION1
|
|
||||||
|
|
||||||
#### Source Code Analysis Tool
|
|
||||||
::DEFINITION1
|
::DEFINITION1
|
||||||
|
|
||||||
#### Style Checker
|
#### Style Checker
|
||||||
|
|
||||||
::DEFINITION1
|
::DEFINITION1
|
||||||
|
|
||||||
#### Source Code Formatter (Pretty Printer)
|
#### Source Code Formatter (Pretty Printer)
|
||||||
|
|
||||||
::DEFINITION1
|
::DEFINITION1
|
||||||
|
|
||||||
#### System Test Automation
|
#### System Test Automation
|
||||||
|
|
||||||
::DEFINITION1
|
::DEFINITION1
|
||||||
|
|
||||||
### Requirements Terms
|
### Requirements Terms
|
||||||
|
|
||||||
#### Feature specification
|
#### Feature specification
|
||||||
|
|
||||||
A feature specification focuses on one feature of a software product
|
A feature specification focuses on one feature of a software product
|
||||||
and completely describes how that feature can be used. It includes a
|
and completely describes how that feature can be used. It includes a
|
||||||
brief description of the purpose of the feature, the input and
|
brief description of the purpose of the feature, the input and
|
||||||
@ -179,8 +191,8 @@ output, and any constraints. Individual bullet items give precise
|
|||||||
details on all aspects of the feature. One feature may be used in
|
details on all aspects of the feature. One feature may be used in
|
||||||
many different ways as part of many different use cases.
|
many different ways as part of many different use cases.
|
||||||
|
|
||||||
|
|
||||||
#### Use case
|
#### Use case
|
||||||
|
|
||||||
The main part of a use case is a set of steps that give an example
|
The main part of a use case is a set of steps that give an example
|
||||||
of how an [actor](#actor) can use the product to succeed at
|
of how an [actor](#actor) can use the product to succeed at
|
||||||
a goal. These steps are called the "Main success scenario", and they
|
a goal. These steps are called the "Main success scenario", and they
|
||||||
@ -188,115 +200,144 @@ include both user intentions and system responses. One use case may
|
|||||||
show how the actor uses several features to accomplish a goal.
|
show how the actor uses several features to accomplish a goal.
|
||||||
|
|
||||||
#### Actor
|
#### Actor
|
||||||
|
|
||||||
A user or an external system that uses the system being built.
|
A user or an external system that uses the system being built.
|
||||||
|
|
||||||
### Design Terms
|
### Design Terms
|
||||||
|
|
||||||
#### ::TERM2
|
#### ::TERM2
|
||||||
|
|
||||||
::DEFINITION2
|
::DEFINITION2
|
||||||
|
|
||||||
### Design Goals Terms
|
### Design Goals Terms
|
||||||
|
|
||||||
#### Correctness
|
#### Correctness
|
||||||
|
|
||||||
This design correctly matches the given requirements.
|
This design correctly matches the given requirements.
|
||||||
|
|
||||||
#### Feasibility
|
#### Feasibility
|
||||||
|
|
||||||
This design can be implemented and tested with the planned amount of
|
This design can be implemented and tested with the planned amount of
|
||||||
time and effort.
|
time and effort.
|
||||||
|
|
||||||
#### Understandability
|
#### Understandability
|
||||||
|
|
||||||
Developers can understand this design and correctly implement it.
|
Developers can understand this design and correctly implement it.
|
||||||
|
|
||||||
#### Implementation phase guidance
|
#### Implementation phase guidance
|
||||||
|
|
||||||
This design divides the implementation into components or aspects
|
This design divides the implementation into components or aspects
|
||||||
that can correspond to reasonable implementation tasks.
|
that can correspond to reasonable implementation tasks.
|
||||||
|
|
||||||
#### Modularity
|
#### Modularity
|
||||||
|
|
||||||
Concerns are clearly separated so that the impact of most design
|
Concerns are clearly separated so that the impact of most design
|
||||||
changes would be limited to only one or a few modules.
|
changes would be limited to only one or a few modules.
|
||||||
|
|
||||||
#### Extensibility
|
#### Extensibility
|
||||||
|
|
||||||
New features or components can be easily added later.
|
New features or components can be easily added later.
|
||||||
|
|
||||||
#### Testability
|
#### Testability
|
||||||
|
|
||||||
It is easy to test components of this design independently, and
|
It is easy to test components of this design independently, and
|
||||||
information is available to help diagnose defects.
|
information is available to help diagnose defects.
|
||||||
|
|
||||||
#### Efficiency
|
#### Efficiency
|
||||||
|
|
||||||
The design enables the system to perform functions with an
|
The design enables the system to perform functions with an
|
||||||
acceptable amount of time, storage space, bandwidth, and
|
acceptable amount of time, storage space, bandwidth, and
|
||||||
other resources.
|
other resources.
|
||||||
|
|
||||||
#### Ease of integration
|
#### Ease of integration
|
||||||
|
|
||||||
The components will work together.
|
The components will work together.
|
||||||
|
|
||||||
#### Capacity matching
|
#### Capacity matching
|
||||||
|
|
||||||
The architecture deploys components onto machines that provide
|
The architecture deploys components onto machines that provide
|
||||||
needed resources with reasonable total expense.
|
needed resources with reasonable total expense.
|
||||||
|
|
||||||
#### Expressiveness
|
#### Expressiveness
|
||||||
|
|
||||||
It allows for storage of all valid values and relationships
|
It allows for storage of all valid values and relationships
|
||||||
|
|
||||||
#### Ease of access
|
#### Ease of access
|
||||||
|
|
||||||
Application code to access stored data is simple
|
Application code to access stored data is simple
|
||||||
|
|
||||||
#### Reliability
|
#### Reliability
|
||||||
|
|
||||||
Stored data cannot easily be corrupted by defective code, concurrent
|
Stored data cannot easily be corrupted by defective code, concurrent
|
||||||
access, or unexpected process termination
|
access, or unexpected process termination
|
||||||
|
|
||||||
#### Data capacity
|
#### Data capacity
|
||||||
|
|
||||||
The system can store the amount of data needed.
|
The system can store the amount of data needed.
|
||||||
|
|
||||||
#### Data security
|
#### Data security
|
||||||
|
|
||||||
Protection of sensitive user and corporate data from unauthorized
|
Protection of sensitive user and corporate data from unauthorized
|
||||||
access or modification
|
access or modification
|
||||||
|
|
||||||
#### Performance
|
#### Performance
|
||||||
|
|
||||||
Data can be accessed quickly
|
Data can be accessed quickly
|
||||||
|
|
||||||
#### Interoperability
|
#### Interoperability
|
||||||
|
|
||||||
The database or data files can be accessed and updated by other
|
The database or data files can be accessed and updated by other
|
||||||
applications
|
applications
|
||||||
|
|
||||||
#### Intrusion prevention
|
#### Intrusion prevention
|
||||||
|
|
||||||
Prevent, e.g., hackers opening a command shell on our server.
|
Prevent, e.g., hackers opening a command shell on our server.
|
||||||
|
|
||||||
#### Abuse prevention
|
#### Abuse prevention
|
||||||
|
|
||||||
Prevention of abuse (e.g., using our system to send spam).
|
Prevention of abuse (e.g., using our system to send spam).
|
||||||
|
|
||||||
#### Auditability
|
#### Auditability
|
||||||
|
|
||||||
All changes can be accounted for later.
|
All changes can be accounted for later.
|
||||||
|
|
||||||
#### Understandability and learnability
|
#### Understandability and learnability
|
||||||
|
|
||||||
Users can reasonably be expected to understand the UI at
|
Users can reasonably be expected to understand the UI at
|
||||||
first sight. Users will be able to discover additional features
|
first sight. Users will be able to discover additional features
|
||||||
without aid from other users or documentation, and they will be able
|
without aid from other users or documentation, and they will be able
|
||||||
to recall what they have learned.
|
to recall what they have learned.
|
||||||
|
|
||||||
#### Task support and efficiency
|
#### Task support and efficiency
|
||||||
|
|
||||||
The UI is well matched to the users' tasks and it can be used with a
|
The UI is well matched to the users' tasks and it can be used with a
|
||||||
reasonable number of clicks and keystrokes.
|
reasonable number of clicks and keystrokes.
|
||||||
|
|
||||||
#### Safety
|
#### Safety
|
||||||
|
|
||||||
Users are not likely to accidentally produce an undesired result
|
Users are not likely to accidentally produce an undesired result
|
||||||
(e.g., delete data, or send a half-finished email).
|
(e.g., delete data, or send a half-finished email).
|
||||||
|
|
||||||
#### Consistency and familiarity
|
#### Consistency and familiarity
|
||||||
|
|
||||||
Users can apply their knowledge of similar UIs or UI standards to
|
Users can apply their knowledge of similar UIs or UI standards to
|
||||||
this system.
|
this system.
|
||||||
|
|
||||||
### QA Terms
|
### QA Terms
|
||||||
|
|
||||||
#### Bug
|
#### Bug
|
||||||
|
|
||||||
*n.* **Deprecated** since 1991. See [defect](#defect).
|
*n.* **Deprecated** since 1991. See [defect](#defect).
|
||||||
|
|
||||||
#### Error
|
#### Error
|
||||||
|
|
||||||
*v.* A mistaken thought in the developer's mind. Often caused by
|
*v.* A mistaken thought in the developer's mind. Often caused by
|
||||||
miscommunication or bad assumptions. Errors can create
|
miscommunication or bad assumptions. Errors can create
|
||||||
[defects](#defect). E.g., a developer might erroneously think that
|
[defects](#defect). E.g., a developer might erroneously think that
|
||||||
the square root of -4 is -2.
|
the square root of -4 is -2.
|
||||||
|
|
||||||
#### Defect
|
#### Defect
|
||||||
|
|
||||||
*n.* The result of the developer's [error](#error) embodied in the
|
*n.* The result of the developer's [error](#error) embodied in the
|
||||||
product source code, initial data, or documents. E.g., a square root
|
product source code, initial data, or documents. E.g., a square root
|
||||||
function which allows negative numbers as arguments is defective.
|
function which allows negative numbers as arguments is defective.
|
||||||
@ -304,6 +345,7 @@ Defects can be removed by changing the source code, initial data,
|
|||||||
or document.
|
or document.
|
||||||
|
|
||||||
#### Fault
|
#### Fault
|
||||||
|
|
||||||
*n.* The execution of defective code. E.g., if a certain input is
|
*n.* The execution of defective code. E.g., if a certain input is
|
||||||
provided to defective code, it may cause an exception, or go into an
|
provided to defective code, it may cause an exception, or go into an
|
||||||
infinite loop, or store an incorrect value in an internal variable.
|
infinite loop, or store an incorrect value in an internal variable.
|
||||||
@ -311,6 +353,7 @@ A fault is not normally visible to users, only the
|
|||||||
[failure](#failure) is visible.
|
[failure](#failure) is visible.
|
||||||
|
|
||||||
#### Failure
|
#### Failure
|
||||||
|
|
||||||
*n.* The user-visible result of a [fault](#fault). E.g., an error
|
*n.* The user-visible result of a [fault](#fault). E.g., an error
|
||||||
message or an incorrect result. This is evidence that can be
|
message or an incorrect result. This is evidence that can be
|
||||||
reported in a defect report. Developers use failure evidence during
|
reported in a defect report. Developers use failure evidence during
|
||||||
@ -319,35 +362,41 @@ debugging to eventually find and remove [defects](#defect).
|
|||||||
### QA Goals Terms
|
### QA Goals Terms
|
||||||
|
|
||||||
#### Functionality > Correctness
|
#### Functionality > Correctness
|
||||||
|
|
||||||
Correctness is the most basic quality goal. It means that, when
|
Correctness is the most basic quality goal. It means that, when
|
||||||
valid inputs are given and the system is in a valid state and under
|
valid inputs are given and the system is in a valid state and under
|
||||||
reasonable load, the system's behavior and results will be correct.
|
reasonable load, the system's behavior and results will be correct.
|
||||||
|
|
||||||
#### Functionality > Robustness
|
#### Functionality > Robustness
|
||||||
|
|
||||||
Robustness is the system's ability to gracefully handle
|
Robustness is the system's ability to gracefully handle
|
||||||
invalid inputs. It should never be possible for any user input to
|
invalid inputs. It should never be possible for any user input to
|
||||||
crash the system or corrupt data, even if that user input is
|
crash the system or corrupt data, even if that user input is
|
||||||
abnormal, unexpected, or malicious.
|
abnormal, unexpected, or malicious.
|
||||||
|
|
||||||
#### Functionality > Accuracy
|
#### Functionality > Accuracy
|
||||||
|
|
||||||
Accuracy refers to the mathematical precision of calculations done
|
Accuracy refers to the mathematical precision of calculations done
|
||||||
by the system. Any system that does numeric calculations must
|
by the system. Any system that does numeric calculations must
|
||||||
consider accuracy, e.g., financial or scientific applications.
|
consider accuracy, e.g., financial or scientific applications.
|
||||||
|
|
||||||
#### Functionality > Compatibility
|
#### Functionality > Compatibility
|
||||||
|
|
||||||
Systems that claim to follow standards or claim compatibility with
|
Systems that claim to follow standards or claim compatibility with
|
||||||
existing systems must adhere to the relevant file formats,
|
existing systems must adhere to the relevant file formats,
|
||||||
protocols, and APIs. The relevant standards are linked at the top of
|
protocols, and APIs. The relevant standards are linked at the top of
|
||||||
this document.
|
this document.
|
||||||
|
|
||||||
#### Functionality > Factual correctness
|
#### Functionality > Factual correctness
|
||||||
|
|
||||||
Is the data in the system a true representation of the real world?
|
Is the data in the system a true representation of the real world?
|
||||||
Any system that contains initial data or gathers data about the real
|
Any system that contains initial data or gathers data about the real
|
||||||
world should be sure that the data is factually correct. E.g., a tax
|
D-DIAGRAM
|
||||||
preparation program should embody correct and up-to-date facts about
|
D-DIAGRAM
|
||||||
tax law.
|
D-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
#### Usability > Understandability and Readability
|
#### Usability > Understandability and Readability
|
||||||
|
|
||||||
Users need to understand the system to use it. The basic metaphor
|
Users need to understand the system to use it. The basic metaphor
|
||||||
should be understandable and appropriate to user tasks. Some defects
|
should be understandable and appropriate to user tasks. Some defects
|
||||||
in understandability include unclear metaphors, poor or hard-to-see
|
in understandability include unclear metaphors, poor or hard-to-see
|
||||||
@ -355,6 +404,7 @@ labels, lack of feedback to confirm the effects of user actions, and
|
|||||||
missing or inadequate on-line help.
|
missing or inadequate on-line help.
|
||||||
|
|
||||||
#### Usability > Learnability and Memorability
|
#### Usability > Learnability and Memorability
|
||||||
|
|
||||||
Every user interface contains some details that users will need to
|
Every user interface contains some details that users will need to
|
||||||
learn and remember. E.g., Alt-F to open the "File" menu. UI cues and
|
learn and remember. E.g., Alt-F to open the "File" menu. UI cues and
|
||||||
rules can make these details easier to learn and remember. E.g., the
|
rules can make these details easier to learn and remember. E.g., the
|
||||||
@ -362,6 +412,7 @@ rules can make these details easier to learn and remember. E.g., the
|
|||||||
accelerator key.
|
accelerator key.
|
||||||
|
|
||||||
#### Usability > Task support
|
#### Usability > Task support
|
||||||
|
|
||||||
This is the quality of match between user tasks and the system's UI.
|
This is the quality of match between user tasks and the system's UI.
|
||||||
Task support defects are cases where the system forces the user to
|
Task support defects are cases where the system forces the user to
|
||||||
take unnatural steps to accomplish a task or where the user is given
|
take unnatural steps to accomplish a task or where the user is given
|
||||||
@ -370,6 +421,7 @@ invent an 8-character filename for their "Christmas card list"?
|
|||||||
E.g., must users total their own tax deductions?
|
E.g., must users total their own tax deductions?
|
||||||
|
|
||||||
#### Usability > Efficiency
|
#### Usability > Efficiency
|
||||||
|
|
||||||
Users should be able to accomplish common tasks with
|
Users should be able to accomplish common tasks with
|
||||||
reasonable effort. Common tasks should be possible with only one or
|
reasonable effort. Common tasks should be possible with only one or
|
||||||
two steps. The difficulty of each step should also be considered.
|
two steps. The difficulty of each step should also be considered.
|
||||||
@ -377,12 +429,14 @@ E.g., does the user have to remember a long code number or click on
|
|||||||
a very small button?
|
a very small button?
|
||||||
|
|
||||||
#### Usability > Safety
|
#### Usability > Safety
|
||||||
|
|
||||||
Humans are error-prone, but the negative effects of common errors
|
Humans are error-prone, but the negative effects of common errors
|
||||||
should be limited. E.g., users should realize that a given command
|
should be limited. E.g., users should realize that a given command
|
||||||
will delete data, and be asked to confirm their intent or have the
|
will delete data, and be asked to confirm their intent or have the
|
||||||
option to undo.
|
option to undo.
|
||||||
|
|
||||||
#### Usability > Consistency and Familiarity
|
#### Usability > Consistency and Familiarity
|
||||||
|
|
||||||
Users should be able to apply their past experience from other
|
Users should be able to apply their past experience from other
|
||||||
similar systems. This means that user interface standards should be
|
similar systems. This means that user interface standards should be
|
||||||
followed, and common conventions should be used whenever possible.
|
followed, and common conventions should be used whenever possible.
|
||||||
@ -390,15 +444,23 @@ Also, UI elements that appear in several parts of the UI should be
|
|||||||
used consistently, unless another UI quality takes priority. E.g.,
|
used consistently, unless another UI quality takes priority. E.g.,
|
||||||
if most currency entry fields do not require a dollar-sign, then one
|
if most currency entry fields do not require a dollar-sign, then one
|
||||||
that does demand it is a consistency defect, unless there is a real
|
that does demand it is a consistency defect, unless there is a real
|
||||||
chance that the user is dealing with another currency on that step
|
chance that the user is dealing with anoD-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
in his/her task.
|
in his/her task.
|
||||||
|
|
||||||
#### Usability > Subjective satisfaction
|
#### Usability > Subjective satisfactionD-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
|
|
||||||
Users should feel generally satisfied with the UI. This is a
|
Users should feel generally satisfied with the UI. This is a
|
||||||
subjective quality that sums up the other user interface qualities
|
subjective quality that sums up the other user interface qualities
|
||||||
as well as aesthetics.
|
as well as aesthetics.
|
||||||
|
|
||||||
#### Security
|
#### Security
|
||||||
|
|
||||||
The system should allow usage only by authorized users, and restrict
|
The system should allow usage only by authorized users, and restrict
|
||||||
usage based on permissions. The system should not allow users to
|
usage based on permissions. The system should not allow users to
|
||||||
side-step security rule or exploit security holes. E.g., all user
|
side-step security rule or exploit security holes. E.g., all user
|
||||||
@ -406,31 +468,46 @@ input should be validated and any malicious input should
|
|||||||
be rejected.
|
be rejected.
|
||||||
|
|
||||||
#### Reliability > Consistency under load
|
#### Reliability > Consistency under load
|
||||||
Every system has some capacity limits. What happens when those
|
D-DIAGRAM
|
||||||
limits are exceeded? The system should never lose or corrupt data.
|
D-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
#### Reliability > Consistency under concurrency
|
#### Reliability > Consistency under concurrency
|
||||||
|
|
||||||
Systems that allow concurrent access by multiple users, or that use
|
Systems that allow concurrent access by multiple users, or that use
|
||||||
concurrency internally, should be free of race conditions
|
concurrency internally, should be free of race conditions
|
||||||
and deadlock.
|
and deadlock.
|
||||||
|
|
||||||
#### Reliability > Availability under load
|
#### Reliability > Availability under load
|
||||||
|
|
||||||
Every system has some capacity limits. What happens when those
|
Every system has some capacity limits. What happens when those
|
||||||
limits are exceeded? The system should continue to service those
|
limits are exceeded? The system should continue to service those
|
||||||
requests that it is capable of handling. It should not crash or stop
|
requests that it is capable of handling. It should not crash or sD-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
processing all requests.
|
processing all requests.
|
||||||
|
|
||||||
#### Reliability > Longevity
|
#### Reliability > Longevity
|
||||||
The system should continue to operate as long as it is needed. It
|
|
||||||
should not gradually use up a limited resource. Example longevity
|
The system should continue to operate as long as it is needed. ItD-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
|
should not gradually use up a limited resource. Example longevityD-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
|
D-DIAGRAM
|
||||||
defects include memory leaks or filling the disk with log files.
|
defects include memory leaks or filling the disk with log files.
|
||||||
|
|
||||||
#### Efficiency
|
#### Efficiency
|
||||||
|
|
||||||
The system's operations should execute quickly, with reasonable use
|
The system's operations should execute quickly, with reasonable use
|
||||||
of machine and network resources. E.g., if one user does one
|
of machine and network resources. E.g., if one user does one
|
||||||
operation, it should execute efficiently.
|
operation, it should execute efficiently.
|
||||||
|
|
||||||
#### Scalability
|
#### Scalability
|
||||||
|
|
||||||
Scalability is a general quality that holds when the system
|
Scalability is a general quality that holds when the system
|
||||||
continues to satisfy its requirements when various usage parameters
|
continues to satisfy its requirements when various usage parameters
|
||||||
are increased. E.g., a file server might be scalable to a high
|
are increased. E.g., a file server might be scalable to a high
|
||||||
@ -438,11 +515,13 @@ number of users, or to very large files or very high capacity disks.
|
|||||||
Several specific scalability goals are listed below.
|
Several specific scalability goals are listed below.
|
||||||
|
|
||||||
#### Scalability > Performance under load
|
#### Scalability > Performance under load
|
||||||
|
|
||||||
This is a specific type of scalability goal dealing with the
|
This is a specific type of scalability goal dealing with the
|
||||||
performance of the system at times when it is servicing many
|
performance of the system at times when it is servicing many
|
||||||
requests from many users.
|
requests from many users.
|
||||||
|
|
||||||
#### Scalability > Large data volume
|
#### Scalability > Large data volume
|
||||||
|
|
||||||
This is a specific type of scalability goal dealing with the ability
|
This is a specific type of scalability goal dealing with the ability
|
||||||
for the system to handle large data sets. Operations should continue
|
for the system to handle large data sets. Operations should continue
|
||||||
to be correct and efficient as data set size increases. Furthermore,
|
to be correct and efficient as data set size increases. Furthermore,
|
||||||
@ -450,6 +529,7 @@ the user interface should still be usable as the data presented to
|
|||||||
users increases in length.
|
users increases in length.
|
||||||
|
|
||||||
#### Operability
|
#### Operability
|
||||||
|
|
||||||
The long-term needs of system administrators should be
|
The long-term needs of system administrators should be
|
||||||
reliably supported. E.g., is the system easy to install? Can the
|
reliably supported. E.g., is the system easy to install? Can the
|
||||||
administrator recover from a crash? Is there sufficient log output
|
administrator recover from a crash? Is there sufficient log output
|
||||||
@ -457,13 +537,16 @@ to diagnose problems in the field? Can the system's data be backed
|
|||||||
up without downtime? Can the system be upgraded practically?
|
up without downtime? Can the system be upgraded practically?
|
||||||
|
|
||||||
#### Maintainability > Understandability
|
#### Maintainability > Understandability
|
||||||
|
|
||||||
Will it be easy for (future) developers to understand how the system
|
Will it be easy for (future) developers to understand how the system
|
||||||
works?
|
works?
|
||||||
|
|
||||||
#### Maintainability > Evolvability
|
#### Maintainability > Evolvability
|
||||||
|
|
||||||
Can the system easily be modified and extended over time?
|
Can the system easily be modified and extended over time?
|
||||||
|
|
||||||
#### Maintainability > Testability
|
#### Maintainability > Testability
|
||||||
|
|
||||||
Can the system easily be tested? Do the requirements precisely
|
Can the system easily be tested? Do the requirements precisely
|
||||||
specify possible inputs and the desired results? Can the system be
|
specify possible inputs and the desired results? Can the system be
|
||||||
tested in parts? When failures are observed, can they be traced back
|
tested in parts? When failures are observed, can they be traced back
|
||||||
|
28
Glossary.md
28
Glossary.md
@ -7,7 +7,7 @@ new team members to be productive.
|
|||||||
Jump to: [A](#a) | [B](#b) | [C](#c) | [D](#d) | [E](#e) | [F](#f) |
|
Jump to: [A](#a) | [B](#b) | [C](#c) | [D](#d) | [E](#e) | [F](#f) |
|
||||||
[G](#g) | [H](#g) | [I](#i) | [J](#j) | [K](#k) | [L](#l) | [M](#m) |
|
[G](#g) | [H](#g) | [I](#i) | [J](#j) | [K](#k) | [L](#l) | [M](#m) |
|
||||||
[N](#n) | [O](#o) | [P](#p) | [Q](#q) | [R](#r) | [S](#s) | [T](#t) |
|
[N](#n) | [O](#o) | [P](#p) | [Q](#q) | [R](#r) | [S](#s) | [T](#t) |
|
||||||
[U](#u) | [V](#v) | [W](#w) | [X](#x) | [Y](#y) | [Z](#z) |
|
[U](#u) | [V](#v) | [W](#w) | [X](#x) | [Y](#y) | [Z](#z) |
|
||||||
[Standard terms](glossary-std.html#standard_terms)
|
[Standard terms](glossary-std.html#standard_terms)
|
||||||
|
|
||||||
### Project-specific Terms
|
### Project-specific Terms
|
||||||
@ -33,13 +33,11 @@ Jump to: [A](#a) | [B](#b) | [C](#c) | [D](#d) | [E](#e) | [F](#f) |
|
|||||||
[GPA](#gpa).*
|
[GPA](#gpa).*
|
||||||
|
|
||||||
#### A
|
#### A
|
||||||
|
|
||||||
|
|
||||||
#### B
|
#### B
|
||||||
|
|
||||||
|
|
||||||
#### C
|
#### C
|
||||||
|
|
||||||
##### ::Class standing
|
##### ::Class standing
|
||||||
|
|
||||||
- ::Computed attribute of [student](#student) based on number of
|
- ::Computed attribute of [student](#student) based on number of
|
||||||
@ -55,15 +53,16 @@ Jump to: [A](#a) | [B](#b) | [C](#c) | [D](#d) | [E](#e) | [F](#f) |
|
|||||||
| ::Senior | ::More than 270 units completed |
|
| ::Senior | ::More than 270 units completed |
|
||||||
|
|
||||||
#### D
|
#### D
|
||||||
|
|
||||||
|
|
||||||
#### G
|
#### G
|
||||||
|
|
||||||
##### ::GEF
|
##### ::GEF
|
||||||
|
|
||||||
::*n.* The [Graph Editing Framework](http://gef.tigris.org/). An open
|
::*n.* The [Graph Editing Framework](http://gef.tigris.org/). An open
|
||||||
source library for editing diagrams (boxes and arrows).
|
source library for editing diagrams (boxes and arrows).
|
||||||
|
|
||||||
##### ::GPA
|
##### ::GPA
|
||||||
|
|
||||||
::*n.* Grade Point Average. GPA is a float between 0.00 and 4.00,
|
::*n.* Grade Point Average. GPA is a float between 0.00 and 4.00,
|
||||||
accurate to 2 decimal places. Computed from average of completed
|
accurate to 2 decimal places. Computed from average of completed
|
||||||
course grades in transcript weighted by course units. Used to
|
course grades in transcript weighted by course units. Used to
|
||||||
@ -71,37 +70,44 @@ determine student ranking, and to trigger Dean's List and
|
|||||||
academic probation.
|
academic probation.
|
||||||
|
|
||||||
#### I
|
#### I
|
||||||
|
|
||||||
##### ::ICS
|
##### ::ICS
|
||||||
|
|
||||||
::*n.* Acronym for the [School of Information and Computer
|
::*n.* Acronym for the [School of Information and Computer
|
||||||
Science](http://www.ics.uci.edu/) at [UC Irvine](http://www.uci.edu/).
|
Science](http://www.ics.uci.edu/) at [UC Irvine](http://www.uci.edu/).
|
||||||
|
|
||||||
#### S
|
#### S
|
||||||
|
|
||||||
##### ::Student
|
##### ::Student
|
||||||
|
|
||||||
::*n.* A person who attends a school to earn a degree. Persistent
|
::*n.* A person who attends a school to earn a degree. Persistent
|
||||||
attributes include: student\_id\_number (primary key), GPA, major,
|
attributes include: student\_id\_number (primary key), GPA, major,
|
||||||
and years\_at\_school.
|
and years\_at\_school.
|
||||||
|
|
||||||
##### ::Senior
|
##### ::Senior
|
||||||
|
|
||||||
::*n.* A senior is special type of [undergraduate](#undergraduate) who
|
::*n.* A senior is special type of [undergraduate](#undergraduate) who
|
||||||
has a certain number of course credits on his or her transcript.
|
has a certain number of course credits on his or her transcript.
|
||||||
Years\_at\_school does not determine senior standing. TODO: how many
|
Years\_at\_school does not determine senior standing. TODO: how many
|
||||||
credits needed?
|
credits needed?
|
||||||
|
|
||||||
#### T
|
#### T
|
||||||
|
|
||||||
##### ::Term1
|
##### ::Term1D-DIAGRAM
|
||||||
|
|
||||||
::Definition1
|
::Definition1
|
||||||
|
|
||||||
##### ::Term2
|
##### ::Term2
|
||||||
|
|
||||||
- ::Definition2a
|
- ::Definition2a
|
||||||
- ::Definition2b
|
- ::Definition2b
|
||||||
|
|
||||||
##### ::Term3
|
##### ::Term3
|
||||||
|
|
||||||
::Definition3
|
::Definition3
|
||||||
|
|
||||||
#### U
|
#### U
|
||||||
|
|
||||||
##### ::Undergraduate
|
##### ::Undergraduate
|
||||||
|
|
||||||
::A type of [student](#student). *TODO: add more detail.*
|
::A type of [student](#student). *TODO: add more detail.*
|
||||||
|
6
Home.md
6
Home.md
@ -1,19 +1,25 @@
|
|||||||
### Mission and Scope
|
### Mission and Scope
|
||||||
|
|
||||||
*TODO: Answer these questions in your own words by filling in each*
|
*TODO: Answer these questions in your own words by filling in each*
|
||||||
|
|
||||||
#### What problem does this project address?
|
#### What problem does this project address?
|
||||||
|
|
||||||
::2-4 SENTENCE PROBLEM
|
::2-4 SENTENCE PROBLEM
|
||||||
|
|
||||||
#### What is the goal of this project?
|
#### What is the goal of this project?
|
||||||
|
|
||||||
::2-4 SENTENCE GOAL
|
::2-4 SENTENCE GOAL
|
||||||
|
|
||||||
#### What is the scope of this project?
|
#### What is the scope of this project?
|
||||||
|
|
||||||
::2-4 SENTENCE SCOPE
|
::2-4 SENTENCE SCOPE
|
||||||
|
|
||||||
#### What development methodology is being used?
|
#### What development methodology is being used?
|
||||||
|
|
||||||
::See our [software development methodology](sdm) document.
|
::See our [software development methodology](sdm) document.
|
||||||
|
|
||||||
#### Where should a new team member start?
|
#### Where should a new team member start?
|
||||||
|
|
||||||
::For more information, see the [project proposal](Proposal).
|
::For more information, see the [project proposal](Proposal).
|
||||||
|
|
||||||
### Status
|
### Status
|
||||||
|
@ -1,10 +1,10 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Release(s):
|
##### Release(s):
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Software Requirements Specification](SRS)
|
- [Software Requirements Specification](SRS)
|
||||||
- [Release notes](Release-Notes)
|
- [Release notes](Release-Notes)
|
||||||
- [FAQ](FAQ)
|
- [FAQ](FAQ)
|
||||||
@ -82,7 +82,7 @@ These objects may be referred to by name in the sections below.*
|
|||||||
|
|
||||||
#### Configuration Files
|
#### Configuration Files
|
||||||
|
|
||||||
- ::PRODUCTNAME.conf: stores application configuration in Java properties file format.
|
- ::PRODUCT-NAME.conf: stores application configuration in Java properties file format.
|
||||||
- ::Section of httpd.conf: configures components of the Apache webserver
|
- ::Section of httpd.conf: configures components of the Apache webserver
|
||||||
|
|
||||||
#### Database Table
|
#### Database Table
|
||||||
@ -95,17 +95,17 @@ These objects may be referred to by name in the sections below.*
|
|||||||
#### Data Files
|
#### Data Files
|
||||||
|
|
||||||
- ::*.ext: Data files saved by the user on their local hard disk.
|
- ::*.ext: Data files saved by the user on their local hard disk.
|
||||||
- ::/var/PRODUCTNAME/upload-XXXX.dat: Files uploaded to the server.
|
- ::/var/PRODUCT-NAME/upload-XXXX.dat: Files uploaded to the server.
|
||||||
|
|
||||||
#### Temporary Files
|
#### Temporary Files
|
||||||
|
|
||||||
- ::/tmp/PRODUCTNAME.pid: Process ID of the currently running server process.
|
- ::/tmp/PRODUCT-NAME.pid: Process ID of the currently running server process.
|
||||||
- ::/tmp/upload-XXXX.dat: Files uploaded to the server before they are processed.
|
- ::/tmp/upload-XXXX.dat: Files uploaded to the server before they are processed.
|
||||||
|
|
||||||
#### Log Files
|
#### Log Files
|
||||||
|
|
||||||
- ::error.log: Serious errors are put in the normal Apache error log. Must be writable by Unix user httpd.
|
- ::error.log: Serious errors are put in the normal Apache error log. Must be writable by Unix user httpd.
|
||||||
- ::PRODUCTNAME.log: Messages indicating the progress of normal operations and some errors. Must be writable by Unix user httpd.
|
- ::PRODUCT-NAME.log: Messages indicating the progress of normal operations and some errors. Must be writable by Unix user httpd.
|
||||||
- ::Log files are rotated nightly. Old logs are archived in ANOTHER LOCATION.
|
- ::Log files are rotated nightly. Old logs are archived in ANOTHER LOCATION.
|
||||||
|
|
||||||
### Implementation of Specific Features
|
### Implementation of Specific Features
|
||||||
@ -116,16 +116,16 @@ impact the work of other groups. E.g., long-running operations that must
|
|||||||
not be interrupted. E.g., start up or shutdown scripts that are
|
not be interrupted. E.g., start up or shutdown scripts that are
|
||||||
automatically run by the operating system.*
|
automatically run by the operating system.*
|
||||||
|
|
||||||
- ::Feature name: 1-3 SENTENCE DESCRIPTION
|
- ::Feature name: 1-3 SENTENCE DESCRIPTION
|
||||||
- ::Feature name: 1-3 SENTENCE DESCRIPTION
|
- ::Feature name: 1-3 SENTENCE DESCRIPTION
|
||||||
- ::Feature name: 1-3 SENTENCE DESCRIPTION
|
- ::Feature name: 1-3 SENTENCE DESCRIPTION
|
||||||
- ::DETAILS
|
- ::DETAILS
|
||||||
- ::DETAILS
|
- ::DETAILS
|
||||||
- ::DETAILS
|
- ::DETAILS
|
||||||
- ::Feature name: 1-3 SENTENCE DESCRIPTION
|
- ::Feature name: 1-3 SENTENCE DESCRIPTION
|
||||||
- ::DETAILS
|
- ::DETAILS
|
||||||
- ::DETAILS
|
- ::DETAILS
|
||||||
- ::DETAILS
|
- ::DETAILS
|
||||||
|
|
||||||
### Operational Procedures
|
### Operational Procedures
|
||||||
|
|
||||||
@ -133,30 +133,37 @@ automatically run by the operating system.*
|
|||||||
engineers when the system is being run in an ASP production environment.*
|
engineers when the system is being run in an ASP production environment.*
|
||||||
|
|
||||||
#### Install
|
#### Install
|
||||||
|
|
||||||
::See the [installation guide](Installation-Guide)
|
::See the [installation guide](Installation-Guide)
|
||||||
|
|
||||||
#### Upgrade
|
#### Upgrade
|
||||||
|
|
||||||
::See the [installation guide](Installation-Guide)
|
::See the [installation guide](Installation-Guide)
|
||||||
|
|
||||||
#### Start Server
|
#### Start Server
|
||||||
|
|
||||||
1. ::STEP 1
|
1. ::STEP 1
|
||||||
2. ::STEP 2
|
2. ::STEP 2
|
||||||
3. ::STEP 3
|
3. ::STEP 3
|
||||||
|
|
||||||
#### Stop Server
|
#### Stop Server
|
||||||
|
|
||||||
1. ::STEP 1
|
1. ::STEP 1
|
||||||
2. ::STEP 2
|
2. ::STEP 2
|
||||||
3. ::STEP 3
|
3. ::STEP 3D-DIAGRAM
|
||||||
|
|
||||||
#### Reload Config Files
|
#### Reload Config Files
|
||||||
|
|
||||||
1. ::STEP 1
|
1. ::STEP 1
|
||||||
2. ::STEP 2
|
2. ::STEP 2
|
||||||
3. ::STEP 3
|
3. ::STEP 3
|
||||||
|
|
||||||
#### Monitor Activity
|
#### Monitor Activity
|
||||||
::Watch the PRODUCTNAME.log and error.log.
|
|
||||||
|
::Watch the PRODUCT-NAME.log and error.log.
|
||||||
|
|
||||||
#### Periodic Cleanup
|
#### Periodic Cleanup
|
||||||
|
|
||||||
::On rare occasion, /tmp/upload-XXXX.dat files can be left behind. Any such files that are more than a day old can safely be removed.
|
::On rare occasion, /tmp/upload-XXXX.dat files can be left behind. Any such files that are more than a day old can safely be removed.
|
||||||
|
|
||||||
### Security
|
### Security
|
||||||
@ -165,11 +172,13 @@ engineers when the system is being run in an ASP production environment.*
|
|||||||
system secure while it is in operation.*
|
system secure while it is in operation.*
|
||||||
|
|
||||||
We take the following precautions to make the system secure
|
We take the following precautions to make the system secure
|
||||||
|
|
||||||
- ::STEP
|
- ::STEP
|
||||||
- ::STEP
|
- ::STEP
|
||||||
- ::STEP
|
- ::STEP
|
||||||
|
|
||||||
The security of the system depends on the following external factors
|
The security of the system depends on the following external factors
|
||||||
|
|
||||||
- ::STEP
|
- ::STEP
|
||||||
- ::STEP
|
- ::STEP
|
||||||
- ::STEP
|
- ::STEP
|
||||||
|
@ -3,17 +3,21 @@
|
|||||||
information.*
|
information.*
|
||||||
|
|
||||||
##### Product:
|
##### Product:
|
||||||
|
|
||||||
::PRODUCT-NAME
|
::PRODUCT-NAME
|
||||||
|
|
||||||
##### Release Number:
|
##### Release Number:
|
||||||
|
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Release Date:
|
##### Release Date:
|
||||||
|
|
||||||
::YEAR/MONTH/DAY
|
::YEAR/MONTH/DAY
|
||||||
|
|
||||||
##### Customer Support:
|
##### Customer Support:
|
||||||
|
|
||||||
:: For more information or support, please visit our
|
:: For more information or support, please visit our
|
||||||
[website](http://www.COMPANY.com/products/PRODUCTNAME/) or
|
[website](http://www.COMPANY.com/products/PRODUCT-NAME/) or
|
||||||
email us at <support@COMPANY.com>
|
email us at <support@COMPANY.com>
|
||||||
|
|
||||||
---
|
---
|
||||||
@ -37,6 +41,7 @@ rather than end-user applications, you should include information on
|
|||||||
needed development and bugging tools, e.g., Ant and JUnit.*
|
needed development and bugging tools, e.g., Ant and JUnit.*
|
||||||
|
|
||||||
#### What other software must be installed first?
|
#### What other software must be installed first?
|
||||||
|
|
||||||
::Before you can install this product, you must install the following
|
::Before you can install this product, you must install the following
|
||||||
packages:
|
packages:
|
||||||
|
|
||||||
@ -46,6 +51,7 @@ packages:
|
|||||||
- ::[OTHER PACKAGES](http://)
|
- ::[OTHER PACKAGES](http://)
|
||||||
|
|
||||||
#### How do I install PRODUCT-NAME?
|
#### How do I install PRODUCT-NAME?
|
||||||
|
|
||||||
:: Please follow these steps
|
:: Please follow these steps
|
||||||
|
|
||||||
1. ::STEP
|
1. ::STEP
|
||||||
@ -55,7 +61,7 @@ packages:
|
|||||||
4. ::STEP
|
4. ::STEP
|
||||||
|
|
||||||
#### How can I uninstall PRODUCT-NAME?
|
#### How can I uninstall PRODUCT-NAME?
|
||||||
|
|
||||||
1. ::STEP
|
1. ::STEP
|
||||||
2. ::STEP
|
2. ::STEP
|
||||||
- ::SUB-STEP
|
- ::SUB-STEP
|
||||||
@ -63,6 +69,7 @@ packages:
|
|||||||
4. ::STEP
|
4. ::STEP
|
||||||
|
|
||||||
#### What if I encounter problems?
|
#### What if I encounter problems?
|
||||||
|
|
||||||
::Please see the troubleshooting section in the [FAQ](FAQ).
|
::Please see the troubleshooting section in the [FAQ](FAQ).
|
||||||
|
|
||||||
### Getting Started
|
### Getting Started
|
||||||
@ -77,7 +84,7 @@ components, include instructions on running unit tests.*
|
|||||||
2. :Run unit tests by typing "ant test"
|
2. :Run unit tests by typing "ant test"
|
||||||
- ::A brief report will be shown on the console
|
- ::A brief report will be shown on the console
|
||||||
- ::A detailed test report for any failed tests will be
|
- ::A detailed test report for any failed tests will be
|
||||||
in build/testout.
|
in build/test-out.
|
||||||
|
|
||||||
#### ::How can I quickly get started using PRODUCT-NAME?
|
#### ::How can I quickly get started using PRODUCT-NAME?
|
||||||
|
|
||||||
|
@ -1,4 +1,4 @@
|
|||||||
##### Related documents:
|
##### Related Documents
|
||||||
- [User Needs](User-Needs)
|
- [User Needs](User-Needs)
|
||||||
- [Interview Notes](interview-notes.html)
|
- [Interview Notes](interview-notes.html)
|
||||||
---
|
---
|
||||||
|
@ -1,22 +1,29 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
|
||||||
|
|
||||||
##### Interviewer(s):
|
::[PROJECT-NAME](Home)
|
||||||
::PERSONNAME
|
|
||||||
|
|
||||||
##### Interviewee(s):
|
##### Interviewer(s)
|
||||||
::PERSONNAME
|
|
||||||
|
::PERSON-NAME
|
||||||
|
|
||||||
|
##### Interviewee(s)
|
||||||
|
|
||||||
|
::PERSON-NAME
|
||||||
|
|
||||||
|
##### Date of Interview
|
||||||
|
|
||||||
##### Date of Interview:
|
|
||||||
::DATE
|
::DATE
|
||||||
|
|
||||||
##### Interview Location:
|
##### Interview Location
|
||||||
|
|
||||||
::LOCATION
|
::LOCATION
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
|
|
||||||
- [Project proposal](Proposal) > [Target audience and benefits](Target-and-Benefits)
|
- [Project proposal](Proposal) > [Target audience and benefits](Target-and-Benefits)
|
||||||
- [Interview checklist](Interview-Checklist)
|
- [Interview checklist](Interview-Checklist)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
*TODO: Copy this file once for each interview. Fill in the details. Link
|
*TODO: Copy this file once for each interview. Fill in the details. Link
|
||||||
@ -36,27 +43,35 @@ type up the answers you received and any additional questions and
|
|||||||
answers, and any new follow-up questions.*
|
answers, and any new follow-up questions.*
|
||||||
|
|
||||||
#### ::How did you learn about the need for this product?
|
#### ::How did you learn about the need for this product?
|
||||||
|
|
||||||
::ANSWER
|
::ANSWER
|
||||||
|
|
||||||
#### ::What types of users are likely to use this product?
|
#### ::What types of users are likely to use this product?
|
||||||
|
|
||||||
::ANSWER
|
::ANSWER
|
||||||
|
|
||||||
#### ::Can you give an example of how a user might actually use the product?
|
#### ::Can you give an example of how a user might actually use the product?
|
||||||
|
|
||||||
::ANSWER
|
::ANSWER
|
||||||
|
|
||||||
#### ::Is there any risk or downside to using the product?
|
#### ::Is there any risk or downside to using the product?
|
||||||
|
|
||||||
::ANSWER
|
::ANSWER
|
||||||
|
|
||||||
#### ::QUESTION1
|
#### ::QUESTION1
|
||||||
|
|
||||||
::ANSWER1
|
::ANSWER1
|
||||||
|
|
||||||
#### ::QUESTION2
|
#### ::QUESTION2
|
||||||
|
|
||||||
::ANSWER2
|
::ANSWER2
|
||||||
|
|
||||||
#### ::QUESTION3
|
#### ::QUESTION3
|
||||||
|
|
||||||
::ANSWER3
|
::ANSWER3
|
||||||
|
|
||||||
#### QUESTION4
|
#### QUESTION4
|
||||||
|
|
||||||
::ANSWER4
|
::ANSWER4
|
||||||
|
|
||||||
### New Questions and Action Items
|
### New Questions and Action Items
|
||||||
@ -67,8 +82,7 @@ Note these new questions and what you must do to find the answer.*
|
|||||||
- ::Can we do X?
|
- ::Can we do X?
|
||||||
- ::Do we support Y?
|
- ::Do we support Y?
|
||||||
- ::Action item: research topic Z
|
- ::Action item: research topic Z
|
||||||
- ::Action item: Send follow-up email as per
|
- ::Action item: Send follow-up email as per [post-interview checklist](Interview-Checklist#post-interview-checklist)
|
||||||
[post-interview checklist](Interview-Checklist#post-interview-checklist)
|
|
||||||
- ::Action item: prepare for next interview with PERSON(S) on DATE
|
- ::Action item: prepare for next interview with PERSON(S) on DATE
|
||||||
|
|
||||||
### Other Interview Notes
|
### Other Interview Notes
|
||||||
|
8
Legal.md
8
Legal.md
@ -1,7 +1,7 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Release Audience:
|
##### Release Audience:
|
||||||
@ -13,7 +13,7 @@
|
|||||||
##### Intended Product License:
|
##### Intended Product License:
|
||||||
::Commercial license
|
::Commercial license
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Project proposal](Proposal) > [Target audience and benefits](Target-and-Benefits)
|
- [Project proposal](Proposal) > [Target audience and benefits](Target-and-Benefits)
|
||||||
- [Project Plan](Project-Plan) > [Resource needs](Resource-Needs)
|
- [Project Plan](Project-Plan) > [Resource needs](Resource-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
|
@ -1,13 +1,16 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
|
||||||
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Project Time-frame:
|
##### Project Time-frame:
|
||||||
::STARTDATE - ENDDATE
|
|
||||||
|
::START-DATE - END-DATE
|
||||||
|
|
||||||
##### Attached worksheets:
|
##### Attached worksheets:
|
||||||
|
|
||||||
- Plan > [Resource Needs](Resource-Needs)
|
- Plan > [Resource Needs](Resource-Needs)
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
|
|
||||||
- [Project Proposal](Proposal) > [Target audience and benefits](Target-and-Benefits)
|
- [Project Proposal](Proposal) > [Target audience and benefits](Target-and-Benefits)
|
||||||
- [Software development methodology](SDM)
|
- [Software development methodology](SDM)
|
||||||
@ -24,6 +27,7 @@ project.
|
|||||||
needed. Use the worksheet to help identify and scope resource needs.*
|
needed. Use the worksheet to help identify and scope resource needs.*
|
||||||
|
|
||||||
### Summary of Project
|
### Summary of Project
|
||||||
|
|
||||||
#### What are the business problem, scope, and goal of this project?
|
#### What are the business problem, scope, and goal of this project?
|
||||||
|
|
||||||
For a summary of this project, see the [Project proposal](Proposal).
|
For a summary of this project, see the [Project proposal](Proposal).
|
||||||
|
24
Proposal.md
24
Proposal.md
@ -1,18 +1,24 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
|
||||||
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Project Time-frame:
|
##### Project Time-frame:
|
||||||
::2003/1/16 to 2003/3/19
|
|
||||||
|
::2003/1/16 to 2003/3/19
|
||||||
|
|
||||||
##### Summary:
|
##### Summary:
|
||||||
::2-4 SENTENCE SUMMARY
|
|
||||||
|
::2-4 SENTENCE SUMMARY
|
||||||
|
|
||||||
##### Attached Worksheets:
|
##### Attached Worksheets:
|
||||||
Project Proposal > [Target audience and benefits](Target-and-Benefits)
|
|
||||||
|
|
||||||
##### Related Documents:
|
Project Proposal > [Target audience and benefits](Target-and-Benefits)
|
||||||
|
|
||||||
|
##### Related Documents
|
||||||
|
|
||||||
- [Project plan](Project-Plan) > [Resource needs](Resource-Needs)
|
- [Project plan](Project-Plan) > [Resource needs](Resource-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**Process impact:** This proposal, along with drafts of related
|
**Process impact:** This proposal, along with drafts of related
|
||||||
@ -92,7 +98,7 @@ those advantages.
|
|||||||
#### Where is there more information on this problem?
|
#### Where is there more information on this problem?
|
||||||
|
|
||||||
::The following pages provide additional background and motivation:
|
::The following pages provide additional background and motivation:
|
||||||
|
|
||||||
- ::[Magazine article on this topic](#)
|
- ::[Magazine article on this topic](#)
|
||||||
- ::[Industry analysis's report on massive-multi-player game market](#)
|
- ::[Industry analysis's report on massive-multi-player game market](#)
|
||||||
- ::[Quotes from game players](#)
|
- ::[Quotes from game players](#)
|
||||||
@ -210,5 +216,5 @@ over time.
|
|||||||
|
|
||||||
### Project Plan
|
### Project Plan
|
||||||
|
|
||||||
See attached draft of [project plan](Project-Plan) and
|
See attached draft of [project plan](Project-Plan)
|
||||||
[resource needs](Resource-Needs).
|
and [resource needs](Resource-Needs).
|
||||||
|
@ -2,10 +2,10 @@
|
|||||||
questions. In cases where multiple answers are already written, delete
|
questions. In cases where multiple answers are already written, delete
|
||||||
those answers that do not apply.*
|
those answers that do not apply.*
|
||||||
|
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number::
|
##### Internal Release Number:
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Release Audience:
|
##### Release Audience:
|
||||||
@ -19,7 +19,7 @@ those answers that do not apply.*
|
|||||||
- QA plan > [System test case suite](Test-Suite)
|
- QA plan > [System test case suite](Test-Suite)
|
||||||
- QA plan > [System test runs](Test-Run-Suite)
|
- QA plan > [System test runs](Test-Run-Suite)
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Software Requirements Specification](SRS)
|
- [Software Requirements Specification](SRS)
|
||||||
- [Design](Design)
|
- [Design](Design)
|
||||||
- [Project plan](Project-Plan)
|
- [Project plan](Project-Plan)
|
||||||
|
@ -2,10 +2,10 @@
|
|||||||
questions. In cases where multiple answers are already written, delete
|
questions. In cases where multiple answers are already written, delete
|
||||||
those answers that do not apply.*
|
those answers that do not apply.*
|
||||||
|
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### External release number:
|
##### External release number:
|
||||||
|
@ -5,7 +5,7 @@ information.*
|
|||||||
number, not internal information.*
|
number, not internal information.*
|
||||||
|
|
||||||
##### Product:
|
##### Product:
|
||||||
::[PRODUCTNAME](http://www.COMPANY.com/products/PRODUCTNAME/)
|
::[PRODUCT-NAME](http://www.COMPANY.com/products/PRODUCT-NAME/)
|
||||||
##### Release Number:
|
##### Release Number:
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
@ -14,14 +14,14 @@ number, not internal information.*
|
|||||||
|
|
||||||
##### Customer Support:
|
##### Customer Support:
|
||||||
::For more information or support, please visit our
|
::For more information or support, please visit our
|
||||||
[website](http://www.COMPANY.com/products/PRODUCTNAME/) or email us
|
[website](http://www.COMPANY.com/products/PRODUCT-NAME/) or email us
|
||||||
at <support@COMPANY.com>
|
at <support@COMPANY.com>
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Introduction
|
### Introduction
|
||||||
|
|
||||||
::This document contains the release notes for PRODUCTNAME version X.Y.Z.
|
::This document contains the release notes for PRODUCT-NAME version X.Y.Z.
|
||||||
The following sections describe the release in detail and provide
|
The following sections describe the release in detail and provide
|
||||||
late-breaking or other information that supplements the main
|
late-breaking or other information that supplements the main
|
||||||
documentation.
|
documentation.
|
||||||
@ -37,7 +37,7 @@ best product possible.
|
|||||||
|
|
||||||
::This is an early access release for wide evaluation and usage. Your
|
::This is an early access release for wide evaluation and usage. Your
|
||||||
feedback is important to us, please help us make this the best product
|
feedback is important to us, please help us make this the best product
|
||||||
possible. Keep in mind that we are continuing to work on PRODUCTNAME and
|
possible. Keep in mind that we are continuing to work on PRODUCT-NAME and
|
||||||
things may change in the future.
|
things may change in the future.
|
||||||
|
|
||||||
::This is the first full release of this product. See the product website
|
::This is the first full release of this product. See the product website
|
||||||
|
@ -1,13 +1,13 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Project Time-frame:
|
##### Project Time-frame:
|
||||||
::STARTDATE - ENDDATE
|
::START-DATE - END-DATE
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Project proposal](Proposal)
|
- [Project proposal](Proposal)
|
||||||
- [Project plan](Project-Plan)
|
- [Project plan](Project-Plan)
|
||||||
- [QA plan](QA-Plan)
|
- [QA plan](QA-Plan)
|
||||||
@ -30,22 +30,22 @@ documents.*
|
|||||||
|
|
||||||
| Need | Resource | Amount | Status | Comments/Responsibilities |
|
| Need | Resource | Amount | Status | Comments/Responsibilities |
|
||||||
|-------------------------------------------|--------------------------------------|------------|------------|---------------------------|
|
|-------------------------------------------|--------------------------------------|------------|------------|---------------------------|
|
||||||
| ::Project Management | ::PERSONNAME | ::20 hours | ::Pending | |
|
| ::Project Management | ::PERSON-NAME | ::20 hours | ::Pending | |
|
||||||
| ::Requirements | ::PERSONNAME | ::20 hours | ::Assigned | |
|
| ::Requirements | ::PERSON-NAME | ::20 hours | ::Assigned | |
|
||||||
| ::Requirements | ::PERSONNAME, PERSONNAME, PERSONNAME | ::10 hours | ::Assigned | |
|
| ::Requirements | ::PERSON-NAME, PERSON-NAME, PERSON-NAME | ::10 hours | ::Assigned | |
|
||||||
| ::Consultation with domain expert | ::PERSONNAME | ::2 hours | ::Pending | |
|
| ::Consultation with domain expert | ::PERSON-NAME | ::2 hours | ::Pending | |
|
||||||
| ::Consultation with topic expert | ::PERSONNAME | ::4 hours | ::Pending | |
|
| ::Consultation with topic expert | ::PERSON-NAME | ::4 hours | ::Pending | |
|
||||||
| ::Training on use of component/technology | ::PERSONNAME | ::8 hours | ::Assigned | |
|
| ::Training on use of component/technology | ::PERSON-NAME | ::8 hours | ::Assigned | |
|
||||||
| ::Overall Design | ::PERSONNAME, PERSONNAME, PERSONNAME | ::20 hours | ::Assigned | |
|
| ::Overall Design | ::PERSON-NAME, PERSON-NAME, PERSON-NAME | ::20 hours | ::Assigned | |
|
||||||
| ::Detailed UI Design | ::PERSONNAME | ::5 hours | ::Pending | |
|
| ::Detailed UI Design | ::PERSON-NAME | ::5 hours | ::Pending | |
|
||||||
| ::Detailed Database Design | ::PERSONNAME | ::5 hours | ::Pending | |
|
| ::Detailed Database Design | ::PERSON-NAME | ::5 hours | ::Pending | |
|
||||||
| ::Development | ::PERSONNAME, PERSONNAME, PERSONNAME | ::40 hours | ::Assigned | |
|
| ::Development | ::PERSON-NAME, PERSON-NAME, PERSON-NAME | ::40 hours | ::Assigned | |
|
||||||
| ::Development | ::PERSONNAME, PERSONNAME | ::80 hours | ::Assigned | |
|
| ::Development | ::PERSON-NAME, PERSON-NAME | ::80 hours | ::Assigned | |
|
||||||
| ::Development | ::PERSONNAME | ::20 hours | ::Pending | |
|
| ::Development | ::PERSON-NAME | ::20 hours | ::Pending | |
|
||||||
| ::Technical writing | ::PERSONNAME, PERSONNAME | ::10 hours | ::Assigned | |
|
| ::Technical writing | ::PERSON-NAME, PERSON-NAME | ::10 hours | ::Assigned | |
|
||||||
| ::QA Planning | ::PERSONNAME | ::10 hours | ::Assigned | |
|
| ::QA Planning | ::PERSON-NAME | ::10 hours | ::Assigned | |
|
||||||
| ::QA Testing | ::PERSONNAME, PERSONNAME, PERSONNAME | ::40 hours | ::Assigned | |
|
| ::QA Testing | ::PERSON-NAME, PERSON-NAME, PERSON-NAME | ::40 hours | ::Assigned | |
|
||||||
| ::Release Engineering | ::PERSONNAME | ::4 hours | ::Assigned | |
|
| ::Release Engineering | ::PERSON-NAME | ::4 hours | ::Assigned | |
|
||||||
|
|
||||||
### Capital Needs
|
### Capital Needs
|
||||||
|
|
||||||
|
@ -1,5 +1,5 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Release Number:
|
##### Release Number:
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
@ -12,12 +12,12 @@
|
|||||||
|
|
||||||
##### Attendees:
|
##### Attendees:
|
||||||
|
|
||||||
- ::PERSONNAME
|
- ::PERSON-NAME
|
||||||
- ::PERSONNAME
|
- ::PERSON-NAME
|
||||||
- ::PERSONNAME
|
- ::PERSON-NAME
|
||||||
- ::PERSONNAME
|
- ::PERSON-NAME
|
||||||
|
|
||||||
##### Related documents:
|
##### Related Documents
|
||||||
- [QA Plan](QA-Plan) > Review Meeting Notes
|
- [QA Plan](QA-Plan) > Review Meeting Notes
|
||||||
- [Review Meeting Checklists](Review-Meeting-Checklists)
|
- [Review Meeting Checklists](Review-Meeting-Checklists)
|
||||||
|
|
||||||
@ -27,9 +27,9 @@
|
|||||||
|
|
||||||
- ::[Feature list section of requirements](#)
|
- ::[Feature list section of requirements](#)
|
||||||
- ::[Multi-user section of requirements](#)
|
- ::[Multi-user section of requirements](#)
|
||||||
- ::[Hello.java](/source/browse/PROJECTNAME/src/Hello.java)
|
- ::[Hello.java](/source/browse/PROJECT-NAME/src/Hello.java)
|
||||||
- ::[HelloStream.java](/source/browse/PROJECTNAME/src/HelloStream.java)
|
- ::[HelloStream.java](/source/browse/PROJECT-NAME/src/HelloStream.java)
|
||||||
- ::[HelloPanel.java](/source/browse/PROJECTNAME/src/HelloPanel.java)
|
- ::[HelloPanel.java](/source/browse/PROJECT-NAME/src/HelloPanel.java)
|
||||||
|
|
||||||
### Meeting Minutes
|
### Meeting Minutes
|
||||||
|
|
||||||
|
120
Risks.md
120
Risks.md
@ -1,10 +1,10 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Project plan](Project-Plan)
|
- [Project plan](Project-Plan)
|
||||||
- [Software development methodology](SDM)
|
- [Software development methodology](SDM)
|
||||||
|
|
||||||
@ -30,73 +30,73 @@ plans to control them. For each risk the plan should include:
|
|||||||
contingency plan if you have a special one for the particular risk.
|
contingency plan if you have a special one for the particular risk.
|
||||||
|
|
||||||
The severity of a risk is its likel
|
The severity of a risk is its likel
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Proposal](Proposal) > Target Audience and Benefits
|
- [Proposal](Proposal) > Target Audience and Benefits
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
---ihood multiplied by its impact. Risks
|
---ihood multiplied by its impact. Risks
|
||||||
are classified as minor if they hav
|
are classified as minor if they hav
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Proposal](Proposal) > Target Audience and Benefits
|
- [Proposal](Proposal) > Target Audience and Benefits
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
---e low likelihood, negligible impact,
|
---e low likelihood, negligible impact,
|
||||||
or medium likelihood and marginal i
|
or medium likelihood and marginal i
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Proposal](Proposal) > Target Audience and Benefits
|
- [Proposal](Proposal) > Target Audience and Benefits
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
---mpact.
|
---mpact.
|
||||||
|
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Proposal](Proposal) > Target Audience and Benefits
|
- [Proposal](Proposal) > Target Audience and Benefits
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
---
|
---
|
||||||
*TODO: You should update these list
|
*TODO: You should update these list
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Proposal](Proposal) > Target Audience and Benefits
|
- [Proposal](Proposal) > Target Audience and Benefits
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
---s regularly. They should be reviewed
|
---s regularly. They should be reviewed
|
||||||
by customers and developers from ti
|
by customers and developers from ti
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Proposal](Proposal) > Target Audience and Benefits
|
- [Proposal](Proposal) > Target Audience and Benefits
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
@ -152,100 +152,100 @@ impact of a risk has increased to make it a "major" risk.*
|
|||||||
| ::Estimate | The development team might not be able to estimate the work time, preventing customers from deciding priorities effectively. | Medium | Marginal | The development team will gain experience in estimating the work, and deliver the first estimates after 12 months. We will compare estimated work to actual work. | Green | Project Manager |
|
| ::Estimate | The development team might not be able to estimate the work time, preventing customers from deciding priorities effectively. | Medium | Marginal | The development team will gain experience in estimating the work, and deliver the first estimates after 12 months. We will compare estimated work to actual work. | Green | Project Manager |
|
||||||
| ::Retention | Some developers may leave the project before it is finished. | Medium | Marginal | Employing locations should provide support for continuing professional development. The project manager will discuss career goals with each developer, and try to assign tasks appropriately. | Green | Project Manager |
|
| ::Retention | Some developers may leave the project before it is finished. | Medium | Marginal | Employing locations should provide support for continuing professional development. The project manager will discuss career goals with each developer, and try to assign tasks appropriately. | Green | Project Manager |
|
||||||
| ::Correctness | The system as delivered may have low take-up because of a lack of confidence in its correctness. | Low | Catastrophic | State of the art [QA activity](QA-Plan). Contingency: stop development of new facilities until the quality of the existing code is assured. | Green | QA Lead
|
| ::Correctness | The system as delivered may have low take-up because of a lack of confidence in its correctness. | Low | Catastrophic | State of the art [QA activity](QA-Plan). Contingency: stop development of new facilities until the quality of the existing code is assured. | Green | QA Lead
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Proposal](Proposal) > Target Audience and Benefits
|
- [Proposal](Proposal) > Target Audience and Benefits
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
--- |
|
--- |
|
||||||
| ::Usability | The system as
|
| ::Usability | The system as
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Proposal](Proposal) > Target Audience and Benefits
|
- [Proposal](Proposal) > Target Audience and Benefits
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
--- delivered may have low take-up because of poor usability.
|
--- delivered may have low take-up because of poor usability.
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Proposal](Proposal) > Target Audience and Benefits
|
- [Proposal](Proposal) > Target Audience and Benefits
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
--- | Low
|
--- | Low
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Proposal](Proposal) > Target Audience and Benefits
|
- [Proposal](Proposal) > Target Audience and Benefits
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
--- | Critical | We will have a UI style guide. Most of the development of the front end will be in close contact with customers. We will review usability later in the project. | Green | UI design lead |
|
--- | Critical | We will have a UI style guide. Most of the development of the front end will be in close contact with customers. We will review usability later in the project. | Green | UI design lead |
|
||||||
| ::Desire | The stated requirements might not match the customers' desires and ambitions for the system. | Low | Critical | Incremental delivery of versions will provide experience of using the system, which will help the customers to identify the real requirements. Indicator: a developer saying "I think they mean ...", a customer saying "They know what I mean". Contingency: request customer review of requirements. | Green | Customers |
|
| ::Desire | The stated requirements might not match the customers' desires and ambitions for the system. | Low | Critical | Incremental delivery of versions will provide experience of using the system, which will help the customers to identify the real requirements. Indicator: a developer saying "I think they mean ...", a customer saying "They know what I mean". Contingency: request customer review of requirements. | Green | Customers |
|
||||||
| ::Changes | After requirements have been documented and agreed, development activities begin to based on them, first design then implementation. If the requirements change later then effort is wasted. | Low | Critical | A change control procedure is required, so changes are only made when the cost is worthwhile. Indicator: compare cost of change t
|
| ::Changes | After requirements have been documented and agreed, development activities begin to based on them, first design then implementation. If the requirements change later then effort is wasted. | Low | Critical | A change control procedure is required, so changes are only made when the cost is worthwhile. Indicator: compare cost of change t
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Proposal](Proposal) > Target Audience and Benefits
|
- [Proposal](Proposal) > Target Audience and Benefits
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
---o new development. Contingency: request customer review of requirements.
|
---o new development. Contingency: request customer review of requirements.
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Proposal](Proposal) > Target Audience and Benefits
|
- [Proposal](Proposal) > Target Audience and Benefits
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
--- | Green | P
|
--- | Green | P
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Proposal](Proposal) > Target Audience and Benefits
|
- [Proposal](Proposal) > Target Audience and Benefits
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
---roject Manager |
|
---roject Manager |
|
||||||
| ::Process | Some develope
|
| ::Process | Some develope
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Proposal](Proposal) > Target Audience and Benefits
|
- [Proposal](Proposal) > Target Audience and Benefits
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
---rs may not cooperate in common standards and processes. | Low | Critical | QA to check conformance, then discussions in development team meetings to change the standard or the actual practice as appropriate. | Green | QA Lead |
|
---rs may not cooperate in common standards and processes. | Low | Critical | QA to check conformance, then discussions in development team meetings to change the standard or the actual practice as appropriate. | Green | QA Lead |
|
||||||
| ::Maintainability | The system as delivered might be hard to maintain. | Low | Marginal | We will review the code for maintainability. | Green | Lead Developer |
|
| ::Maintainability | The system as delivered might be hard to maintain. | Low | Marginal | We will review the code for maintainability. | Green | Lead Developer |
|
||||||
| ::RISKNAME | ONE-TO-THREE-SENTENCES | Low or Medium or High | Negligible or Marginal or Critical or Catastrophic | ONE-TO-THREE-SENTENCES | Red or Amber or Green | PERSONNAME |
|
| ::RISKNAME | ONE-TO-THREE-SENTENCES | Low or Medium or High | Negligible or Marginal or Critical or Catastrophic | ONE-TO-THREE-SENTENCES | Red or Amber or Green | PERSON-NAME |
|
||||||
|
|
||||||
#### Possible risk status values
|
#### Possible risk status values
|
||||||
|
|
||||||
|
8
SRS.md
8
SRS.md
@ -1,14 +1,14 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::PROJECTNAME
|
::PROJECT-NAME
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Attached worksheets:
|
##### Attached worksheets:
|
||||||
- SRS > [Use case suite](Use-Case-Suite)
|
- SRS > [Use case suite](Use-Case-Suite)
|
||||||
- SRS > [Feature set](Feature-Set)
|
- SRS > [Feature set](Feature-Set)
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
- ::LINKS TO OTHER DOCUMENTS
|
- ::LINKS TO OTHER DOCUMENTS
|
||||||
|
@ -5,8 +5,8 @@ available.*
|
|||||||
*TODO: Edit the rows in the following table. In some rows, multiple
|
*TODO: Edit the rows in the following table. In some rows, multiple
|
||||||
examples are given, you should select/edit only one.*
|
examples are given, you should select/edit only one.*
|
||||||
|
|
||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Status Report Date:
|
##### Status Report Date:
|
||||||
::YEAR/MONTH/DAY
|
::YEAR/MONTH/DAY
|
||||||
@ -34,10 +34,10 @@ examples are given, you should select/edit only one.*
|
|||||||
- ::[3 enhancements]()
|
- ::[3 enhancements]()
|
||||||
|
|
||||||
##### Resources used this period:
|
##### Resources used this period:
|
||||||
- ::PERSONNAME: 18 hours.
|
- ::PERSON-NAME: 18 hours.
|
||||||
- ::PERSONNAME: 15 hours.
|
- ::PERSON-NAME: 15 hours.
|
||||||
- ::PERSONNAME: 10 hours.
|
- ::PERSON-NAME: 10 hours.
|
||||||
- ::PERSONNAME: 12 hours.
|
- ::PERSON-NAME: 12 hours.
|
||||||
|
|
||||||
##### Status Summary:
|
##### Status Summary:
|
||||||
- ::Project completed. This is the final status report.
|
- ::Project completed. This is the final status report.
|
||||||
@ -46,8 +46,8 @@ examples are given, you should select/edit only one.*
|
|||||||
- ::High risk. Advice from management and stakeholders needed.
|
- ::High risk. Advice from management and stakeholders needed.
|
||||||
- ::Project canceled. This is the final status report.
|
- ::Project canceled. This is the final status report.
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Project plan](Project-Plan) > [Resource needs](Resource-Needs)
|
- [Project plan](Project-Plan) > [Resource needs](Resource-Needs)
|
||||||
- [QA plan](QA-Plan)
|
- [QA plan](QA-Plan)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
---
|
---
|
||||||
|
@ -1,10 +1,10 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Proposal](Proposal) > Target Audience and Benefits
|
- [Proposal](Proposal) > Target Audience and Benefits
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
@ -69,7 +69,7 @@ products. Benefits to the development organization should be listed in
|
|||||||
[Risks and Rewards](Project-Plan#risk-management).*
|
[Risks and Rewards](Project-Plan#risk-management).*
|
||||||
|
|
||||||
*TIP: If you can rank benefits by value, use numbered lists (the HTML
|
*TIP: If you can rank benefits by value, use numbered lists (the HTML
|
||||||
<ol> tag), otherwise use bullet lists (the HTML <ul> tag).*
|
<ol> tag), otherwise use bullet lists (the HTML <ul> tag).*
|
||||||
|
|
||||||
- ::Increases play-value
|
- ::Increases play-value
|
||||||
- ::Many players enjoy games more when they play as a team.
|
- ::Many players enjoy games more when they play as a team.
|
||||||
|
@ -1,5 +1,5 @@
|
|||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [QA Plan](QA-Plan) > [Test Suite](Test-Suite) > Test Case Format
|
- [QA Plan](QA-Plan) > [Test Suite](Test-Suite) > Test Case Format
|
||||||
---
|
---
|
||||||
|
|
||||||
|
@ -1,10 +1,10 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
[QA Plan](QA-Plan) > [Test Suite](Test-Suite) > Test Cases
|
[QA Plan](QA-Plan) > [Test Suite](Test-Suite) > Test Cases
|
||||||
[System test case format](Test-Case-Format)
|
[System test case format](Test-Case-Format)
|
||||||
::LINKS TO RELEVANT STANDARDS
|
::LINKS TO RELEVANT STANDARDS
|
||||||
|
@ -1,10 +1,10 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [QA Plan](QA-Plan) > Test Run Suite
|
- [QA Plan](QA-Plan) > Test Run Suite
|
||||||
- [Test suite](Test-Suite)
|
- [Test suite](Test-Suite)
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
|
@ -1,10 +1,10 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [QA Plan](QA-Plan) > [Test Run Suite](Test-Run-Suite) > Test Runs
|
- [QA Plan](QA-Plan) > [Test Run Suite](Test-Run-Suite) > Test Runs
|
||||||
- [Test suit](Test-Suite)
|
- [Test suit](Test-Suite)
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
|
@ -1,10 +1,10 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [QA Plan](QA-Plan) > Test Suite
|
- [QA Plan](QA-Plan) > Test Suite
|
||||||
- [Test case format](Test-Case-Format)
|
- [Test case format](Test-Case-Format)
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
|
@ -1,10 +1,10 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [SRS](SRS) > Use Case Suite
|
- [SRS](SRS) > Use Case Suite
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs)
|
- [Project proposal](Proposal) > [User needs](User-Needs)
|
||||||
- [SRS](SRS) > [Feature set](Feature-Set)
|
- [SRS](SRS) > [Feature set](Feature-Set)
|
||||||
|
26
Use-Cases.md
26
Use-Cases.md
@ -1,16 +1,16 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::PROJECTNAME
|
::PROJECT-NAME
|
||||||
|
|
||||||
##### Internal Release Number:
|
##### Internal Release Number
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [SRS](SRS) > [Use Case Suite](Use-Case-Suite) > Use Cases
|
- [SRS](SRS) > [Use Case Suite](Use-Case-Suite) > Use Cases
|
||||||
- [Project proposal](Proposal) > [User needs](User-Needs), [SRS](SRS) > [Feature set](Feature-Set)
|
- [Project proposal](Proposal) > [User needs](User-Needs), [SRS](SRS) > [Feature set](Feature-Set)
|
||||||
- [Use case format](Use-Case-Format)
|
- [Use case format](Use-Case-Format)
|
||||||
- ::LINK TO USE CASE DIAGRAM
|
- ::LINK TO USE CASE DIAGRAM
|
||||||
- ::LINKS TO RELEVANT STANDARDS
|
- ::LINKS TO RELEVANT STANDARDS
|
||||||
- ::LINKS TO OTHER DOCUMENTS
|
- ::LINKS TO OTHER DOCUMENTS
|
||||||
---
|
---
|
||||||
|
|
||||||
*TODO: Note any aspects that are common to all use cases here. This helps
|
*TODO: Note any aspects that are common to all use cases here. This helps
|
||||||
@ -21,10 +21,10 @@ note it's specific value to replace or add to the default.*
|
|||||||
|
|
||||||
**Direct Actors:**
|
**Direct Actors:**
|
||||||
|
|
||||||
- ::User: end-user in any role
|
- ::User: end-user in any role
|
||||||
- ::System: The system being built
|
- ::System: The system being built
|
||||||
- ::When actors are not listed, assume User is doing it.
|
- ::When actors are not listed, assume User is doing it.
|
||||||
- ::Items beginning with "see" indicate that System has presented a new screen.
|
- ::Items beginning with "see" indicate that System has presented a new screen.
|
||||||
|
|
||||||
**Stakeholders:**
|
**Stakeholders:**
|
||||||
|
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
information.*
|
information.*
|
||||||
|
|
||||||
##### Product:
|
##### Product:
|
||||||
::[PRODUCTNAME](http://www.COMPANY.com/products/PRODUCTNAME/)
|
::[PRODUCT-NAME](http://www.COMPANY.com/products/PRODUCT-NAME/)
|
||||||
|
|
||||||
##### Release Number:
|
##### Release Number:
|
||||||
::X.Y.Z
|
::X.Y.Z
|
||||||
@ -13,7 +13,7 @@ information.*
|
|||||||
|
|
||||||
##### Customer Support:
|
##### Customer Support:
|
||||||
::For more information or support, please visit our
|
::For more information or support, please visit our
|
||||||
[website](http://www.COMPANY.com/products/PRODUCTNAME/) or email
|
[website](http://www.COMPANY.com/products/PRODUCT-NAME/) or email
|
||||||
us at <support@COMPANY.com>
|
us at <support@COMPANY.com>
|
||||||
|
|
||||||
---
|
---
|
||||||
|
@ -1,10 +1,10 @@
|
|||||||
##### Project:
|
##### Project
|
||||||
::[PROJECTNAME](Home)
|
::[PROJECT-NAME](Home)
|
||||||
|
|
||||||
##### Attached worksheets:
|
##### Attached worksheets:
|
||||||
- User needs > [Interview notes](interview-notes.html)
|
- User needs > [Interview notes](interview-notes.html)
|
||||||
|
|
||||||
##### Related Documents:
|
##### Related Documents
|
||||||
- [Project proposal](Proposal) > [Target audience and benefits](Target-and-Benefits)
|
- [Project proposal](Proposal) > [Target audience and benefits](Target-and-Benefits)
|
||||||
- [Software requirements specification](SRS)
|
- [Software requirements specification](SRS)
|
||||||
- [Glossary](Glossary)
|
- [Glossary](Glossary)
|
||||||
@ -190,7 +190,7 @@ website and join. (Source: [INTERVIEWEE](interview-notes.html))
|
|||||||
:: Bob is visiting his friend. He tries to use his friend's computer to
|
:: Bob is visiting his friend. He tries to use his friend's computer to
|
||||||
log onto the RedDawn SuperShooter tournament. But, he does not
|
log onto the RedDawn SuperShooter tournament. But, he does not
|
||||||
remember the exact name of the server. So, he visits the RedDawn
|
remember the exact name of the server. So, he visits the RedDawn
|
||||||
clan website to find that information. (Source: PERSONNAME)
|
clan website to find that information. (Source: PERSON-NAME)
|
||||||
|
|
||||||
#### STORYNAME1
|
#### STORYNAME1
|
||||||
:: PARAGRAPH
|
:: PARAGRAPH
|
||||||
|
@ -1,5 +1,5 @@
|
|||||||
::Your-Organization Proprietary
|
::Your-Organization Proprietary
|
||||||
|
|
||||||
Copyright 2003-2004 Jason Robbins. All rights reserved. [License terms](LICENSE). Retain this copyright statement whenever this file is used as a template.
|
Copyright 2003-2004 Jason Robbins. All rights reserved. [License terms](LICENSE). Retain this copyright statement whenever this file is used as a template.
|
||||||
|
|
||||||
Find [Readyset GFM](https://github.com/bike-bill/readyset-gfm) on Github.
|
Find [Readyset GFM](https://github.com/bike-bill/readyset-gfm) on Github.
|
Loading…
Reference in New Issue
Block a user