Suborbital-Systems/ReadySetGit
2
0
Fork 0
Code Pull Requests Packages Projects Releases Activity

Linter cleanup

Browse Source
This commit is contained in:
William Sandner 2018-08-24 12:30:24 +02:00
parent af07911365
commit fb1bdcf829
26 changed files with 664 additions and 694 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
Interview-Checklist.md
View File

@ -1,6 +1,8 @@
##### Related Documents ##### Related Documents
- [User Needs](User-Needs) - [User Needs](User-Needs)
- [Interview Notes](interview-notes.html) - [Interview Notes](interview-notes.html)
--- ---
**Process impact:** This checklist will help you plan customer **Process impact:** This checklist will help you plan customer

15
Legal.md
View File

@ -1,22 +1,28 @@
##### Project ##### Project
::[PROJECT-NAME](Home) ::[PROJECT-NAME](Home)
##### Internal Release Number ##### Internal Release Number
::X.Y.Z ::X.Y.Z
##### Release Audience: ##### Release Audience:
- ::General availability release || - ::General availability release ||
- ::Customer-specific release: CUSTOMER(S) || - ::Customer-specific release: CUSTOMER(S) ||
- ::Developer release (Internal usage only) || - ::Developer release (Internal usage only) ||
- ::Early access release (Controlled external access) - ::Early access release (Controlled external access)
##### 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)
--- ---
**Process impact:** This document outlines legal issues that may affect **Process impact:** This document outlines legal issues that may affect
@ -49,10 +55,11 @@ professional counsel for review as needed.*
| ::Privacy | ::Cannot collect personal information from minors | ::In compliance | ::We ask for user age before asking for other information | | ::Privacy | ::Cannot collect personal information from minors | ::In compliance | ::We ask for user age before asking for other information |
| ::Industry certification | ::Game industry rating | ::In compliance | ::We follow guidelines for "Everyone" rating | | ::Industry certification | ::Game industry rating | ::In compliance | ::We follow guidelines for "Everyone" rating |
##### Possible Status Values > **Possible Status Values**
- In compliance: we are OK to go ahead with this release >
- Waived: we decided not to consider this aspect for this release > - In compliance: we are OK to go ahead with this release
- Violated: we are not conforming. Comment should describe impact. > - Waived: we decided not to consider this aspect for this release
> - Violated: we are not conforming. Comment should describe impact.
### Legal Issues Checklist ### Legal Issues Checklist

11
License.md
View File

@ -10,15 +10,8 @@ Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions modification, are permitted provided that the following conditions
are met: are met:
1. Redistributions of these files must retain the above copyright 1. Redistributions of these files must retain the above copyright notice, this list of conditions and the following disclaimer. The individual template files must retain the copyright footnote whenever they are used as templates.
notice, this list of conditions and the following disclaimer. The 2. The name "ReadySET" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact jrobbins@jrobbins.org.
individual template files must retain the copyright footnote whenever
they are used as templates.
2. The name "ReadySET" must not be used to endorse or promote
products derived from this software without prior written
permission. For written permission, please contact
jrobbins@jrobbins.org.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF

80
Project-Plan.md
View File

@ -59,6 +59,7 @@ For a summary of this project, see the [Project proposal](Proposal).
- ::Issue XXXX made us realize that we forgot to plan time for DEVELOPMENT-TASK. - ::Issue XXXX made us realize that we forgot to plan time for DEVELOPMENT-TASK.
### Summary of Methodology ### Summary of Methodology
#### What general development approach will be used? #### What general development approach will be used?
::THREE TO FIVE SENTENCES OR BULLETS HERE. COVER GENERAL APPROACH, IMPORTANT ASSUMPTIONS, KEY PRACTICES, AND PROJECT COORDINATION CONTROLS. ::THREE TO FIVE SENTENCES OR BULLETS HERE. COVER GENERAL APPROACH, IMPORTANT ASSUMPTIONS, KEY PRACTICES, AND PROJECT COORDINATION CONTROLS.
@ -83,19 +84,11 @@ For more information see the [Software Development Methodology](SDM).
#### How will changes be controlled? #### How will changes be controlled?
- ::Requests for requirements changes will be tracked in the issue - ::Requests for requirements changes will be tracked in the issue tracker
tracker - ::The change control board ([CCB](Glossary#ccb)) will review requested changes and authorize work on them as appropriate
- ::The change control board ([CCB](Glossary#ccb)) - ::After the [feature complete](Glossary#featurecomplete) milestone, no new features will be added to this release.
will review requested changes and authorize work on them as - ::After the [code complete](Glossary#codecomplete) milestone, no entirely new product source code will be added to this release.
appropriate - ::All source code commit log messages must refer to a specific issue ID, after the feature complete milestone.
- ::After the [feature
complete](Glossary#featurecomplete) milestone, no
new features will be added to this release.
- ::After the [code complete](Glossary#codecomplete)
milestone, no entirely new product source code will be added to
this release.
- ::All source code commit log messages must refer to a specific
issue ID, after the feature complete milestone.
#### How will this plan be updated? #### How will this plan be updated?
@ -204,45 +197,28 @@ Please see the [risks worksheet](Risks).
#### The main risks of this project are #### The main risks of this project are
1. ::There is a potential conflict between the goals of a high-quality 1. ::There is a potential conflict between the goals of a high-quality appearance and one that is completely customizable. We can only succeed if players find the web site appealing, and game vendors can customize it with no more effort than would be needed to build a static website. We already have a design in mind that will address this risk and we will review it with a web site designer who worked for a game vendor site.
appearance and one that is completely customizable. We can only 2. ::There are significant technical difficulties in building a web site and web application. This will be a risk because one person on our team has much experience with the relevant tools and technologies. Although the others will learn, we will certainly make some mistakes and sub-optimal choices. We will address this risk by scoping the project such that we have enough time to train and to review the design and implementation.
succeed if players find the web site appealing, and game vendors can 3. ::The schedule for this project is very short. We will manage this by planning a conservatively scoped functional core and series of functional enhancements that can be individually slipped to later releases if needed.
customize it with no more effort than would be needed to build a 4. ::The performance of the system will be significantly impacted by the decisions made during the [database design task](#3.2.C). None of our current team members has experience with database optimization. To address this, we will arrange a review meeting with an experienced DBA or hire a consultant from the database vendor.
static website. We already have a design in mind that will address 5. ::We could be underestimating known tasks.
this risk and we will review it with a web site designer who worked HOW TO AVOID/MITIGATE?
for a game vendor site. 6. ::We could be underestimating the impact of unknown tasks.
2. ::There are significant technical difficulties in building a web site HOW TO AVOID/MITIGATE?
and web application. This will be a risk because one person on our 7. ::We could be underestimating the dependencies between tasks.
team has much experience with the relevant tools and technologies. HOW TO AVOID/MITIGATE?
Although the others will learn, we will certainly make some mistakes 8. ::We could have misunderstood the customer's requirements.
and sub-optimal choices. We will address this risk by scoping the HOW TO AVOID/MITIGATE?
project such that we have enough time to train and to review the 9. ::The customer could change the requirements.
design and implementation. HOW TO AVOID/MITIGATE?
3. ::The schedule for this project is very short. We will manage this by 10. ::We could face major difficulties with the technology chosen for this project.
planning a conservatively scoped functional core and series of HOW TO AVOID/MITIGATE?
functional enhancements that can be individually slipped to later 11. ::We could have low quality that demands significant rework.
releases if needed. HOW TO AVOID/MITIGATE?
4. ::The performance of the system will be significantly impacted by the 12. ::We could incorrectly assess our progress until it is too late to react.
decisions made during the [database design task](#3.2.C). None of HOW TO AVOID/MITIGATE?
our current team members has experience with database optimization. 13. ::We could lose resources. E.g., team members could get sick, spend time on other projects, or quit.
To address this, we will arrange a review meeting with an HOW TO AVOID/MITIGATE?
experienced DBA or hire a consultant from the database vendor.
5. ::We could be underestimating known tasks. HOW TO AVOID/MITIGATE?
6. ::We could be underestimating the impact of unknown tasks. HOW TO
AVOID/MITIGATE?
7. ::We could be underestimating the dependencies between tasks. HOW TO
AVOID/MITIGATE?
8. ::We could have misunderstood the customer's requirements. HOW TO
AVOID/MITIGATE?
9. ::The customer could change the requirements. HOW TO AVOID/MITIGATE?
10. ::We could face major difficulties with the technology chosen for
this project. HOW TO AVOID/MITIGATE?
11. ::We could have low quality that demands significant rework. HOW TO
AVOID/MITIGATE?
12. ::We could incorrectly assess our progress until it is too late
to react. HOW TO AVOID/MITIGATE?
13. ::We could lose resources. E.g., team members could get sick, spend
time on other projects, or quit. HOW TO AVOID/MITIGATE?
14. ::There may be a mis-alignment of stakeholder goals or expectations. 14. ::There may be a mis-alignment of stakeholder goals or expectations.
HOW TO AVOID/MITIGATE? HOW TO AVOID/MITIGATE?

6
QA-Plan.md
View File

@ -3,23 +3,28 @@ questions. In cases where multiple answers are already written, delete
those answers that do not apply.* those answers that do not apply.*
##### Project ##### Project
::[PROJECT-NAME](Home) ::[PROJECT-NAME](Home)
##### Internal Release Number: ##### Internal Release Number:
::X.Y.Z ::X.Y.Z
##### Release Audience: ##### Release Audience:
- ::General availability release || - ::General availability release ||
- ::Customer-specific release: CUSTOMER(S) || - ::Customer-specific release: CUSTOMER(S) ||
- ::Developer release (Internal usage only) || - ::Developer release (Internal usage only) ||
- ::Early access release (Controlled external access) - ::Early access release (Controlled external access)
##### Attached Worksheets: ##### Attached Worksheets:
- QA plan > [Review meeting notes](Review-Meeting-Notes) - QA plan > [Review meeting notes](Review-Meeting-Notes)
- 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)
@ -76,6 +81,7 @@ on the following components and aspects:
- ::FEATURE-2 - ::FEATURE-2
#### What is the summary of this plan? #### What is the summary of this plan?
::In this release we will continue to use development practices that ::In this release we will continue to use development practices that
support all of our quality goals, but we will focus on functional support all of our quality goals, but we will focus on functional
correctness and robustness. We will do that with the following major correctness and robustness. We will do that with the following major

9
Release-Checklist.md
View File

@ -3,19 +3,24 @@ questions. In cases where multiple answers are already written, delete
those answers that do not apply.* those answers that do not apply.*
##### Project ##### Project
::[PROJECT-NAME](Home) ::[PROJECT-NAME](Home)
##### Internal Release Number ##### Internal Release Number
::X.Y.Z ::X.Y.Z
##### External release number: ##### External release number
::X.Y.Z ::X.Y.Z
##### Release audience: ##### Release audience
- ::General availability release - ::General availability release
- ::Customer-specific release: CUSTOMER(S) - ::Customer-specific release: CUSTOMER(S)
- ::Developer release (Internal usage only) - ::Developer release (Internal usage only)
- ::Early access release (Controlled external access) - ::Early access release (Controlled external access)
--- ---
**Process impact:** The process of working through this checklist helps **Process impact:** The process of working through this checklist helps

27
Release-Notes.md
View File

@ -4,15 +4,20 @@ information.*
*TODO: Make sure to use the **product** name and **external** release *TODO: Make sure to use the **product** name and **external** release
number, not internal information.* number, not internal information.*
##### Product: ##### Product
::[PRODUCT-NAME](http://www.COMPANY.com/products/PRODUCT-NAME/) ::[PRODUCT-NAME](http://www.COMPANY.com/products/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/PRODUCT-NAME/) or email us [website](http://www.COMPANY.com/products/PRODUCT-NAME/) or email us
at <support@COMPANY.com> at <support@COMPANY.com>
@ -102,33 +107,33 @@ information can be helpful.*
### ::Minimum System Requirements ### ::Minimum System Requirements
#### ::System Processor: #### ::System Processor
::800MHz ::800MHz
#### ::System Memory: #### ::System Memory
::256MB ::256MB
#### ::Free Disk Space: #### ::Free Disk Space
::10MB ::10MB
#### ::Operating System: #### ::Operating System
::Windows 2000, Windows XP, Mac OS X, Linux (kernel 2.4) ::Windows 2000, Windows XP, Mac OS X, Linux (kernel 2.4)
#### ::Networking: #### ::Networking
::Internet access ::Internet access
#### ::Existing Software: #### ::Existing Software
- ::Standard e-mail client - ::Standard e-mail client
- ::Popular web browser (IE6, NN7) - ::Popular web browser (IE6, NN7)
- ::SuperWaveEdit(TM) 2.0.2 (Needed for custom playback modes) - ::SuperWaveEdit(TM) 2.0.2 (Needed for custom playback modes)
#### ::Version Compatibility: #### ::Version Compatibility
::Files saved by earlier versions of this product may be used with ::Files saved by earlier versions of this product may be used with
this version. However, wave files saved in version W.Y.Z, must be this version. However, wave files saved in version W.Y.Z, must be

5
Resource-Needs.md
View File

@ -1,18 +1,23 @@
##### Project ##### Project
::[PROJECT-NAME](Home) ::[PROJECT-NAME](Home)
##### Internal Release Number ##### Internal Release Number
::X.Y.Z ::X.Y.Z
##### Project Time-frame: ##### Project Time-frame:
::START-DATE - END-DATE ::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)
- [Software development methodology](SDM) - [Software development methodology](SDM)
- [Glossary](Glossary) - [Glossary](Glossary)
--- ---
**Process impact:** Based on the project plan and the worksheet below, **Process impact:** Based on the project plan and the worksheet below,

5
Review-Meeting-Checklists.md
View File

@ -1,14 +1,15 @@
# Review Meeting Checklists # Review Meeting Checklists
--- ---
### Checklists for Types of Artifacts ## Checklists for Types of Artifacts
- ::[Checklists for peer reviews](http://processimpact.com/pr_goodies.shtml) - ::[Checklists for peer reviews](http://processimpact.com/pr_goodies.shtml)
by Karl E. Wiegers by Karl E. Wiegers
- ::[Checklists for UML design](http://www.modelingstyle.info/) - ::[Checklists for UML design](http://www.modelingstyle.info/)
by Scott W. Ambler by Scott W. Ambler
### Style Guides ## Style Guides
- ::[Sun's java style guide](http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html) - ::[Sun's java style guide](http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html)
- ::[Sun's javadoc guide](http://java.sun.com/j2se/javadoc/writingdoccomments/) - ::[Sun's javadoc guide](http://java.sun.com/j2se/javadoc/writingdoccomments/)

13
Review-Meeting-Notes.md
View File

@ -1,16 +1,20 @@
##### Project ##### Project
::[PROJECT-NAME](Home) ::[PROJECT-NAME](Home)
##### Release Number: ##### Release Number
::X.Y.Z ::X.Y.Z
##### Location of Meeting: ##### Location of Meeting
::LOCATION, BUILDING, ROOM ::LOCATION, BUILDING, ROOM
##### Date and Time of Meeting: ##### Date and Time of Meeting
::YEAR/MONTH/DAY HH:MM ::YEAR/MONTH/DAY HH:MM
##### Attendees: ##### Attendees
- ::PERSON-NAME - ::PERSON-NAME
- ::PERSON-NAME - ::PERSON-NAME
@ -18,6 +22,7 @@
- ::PERSON-NAME - ::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)

199
Risks.md
View File

@ -1,14 +1,18 @@
##### Project ##### Project
::[PROJECT-NAME](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)
##### References: ##### References:
- [Risk Management during Requirements](http://www.systemsguild.com/pdfs/s5req.lo%201.pdf) by Tom DeMarco and Tim Lister - [Risk Management during Requirements](http://www.systemsguild.com/pdfs/s5req.lo%201.pdf) by Tom DeMarco and Tim Lister
- [Taxonomy-Based Risk Identification](http://www.sei.cmu.edu/pub/documents/93.reports/pdf/tr06.93.pdf) by Carr, Konda, Monarch, Ulrich, and Walker (SEI) - [Taxonomy-Based Risk Identification](http://www.sei.cmu.edu/pub/documents/93.reports/pdf/tr06.93.pdf) by Carr, Konda, Monarch, Ulrich, and Walker (SEI)
@ -29,82 +33,15 @@ plans to control them. For each risk the plan should include:
general contingency plans. In this case you only need to give a general contingency plans. In this case you only need to give a
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 likelihood multiplied by its impact. Risks
##### Project are classified as minor if they have low likelihood, negligible impact,
::[PROJECT-NAME](Home) or medium likelihood and marginal impact.
##### Internal Release Number *TODO: You should update these lists regularly. They should be reviewed
::X.Y.Z by customers and developers from time to time.*
##### Related Documents
- [Proposal](Proposal) > Target Audience and Benefits
- [Project proposal](Proposal) > [User needs](User-Needs)
- [Glossary](Glossary)
---ihood multiplied by its impact. Risks
are classified as minor if they hav
##### Project
::[PROJECT-NAME](Home)
##### Internal Release Number
::X.Y.Z
##### Related Documents
- [Proposal](Proposal) > Target Audience and Benefits
- [Project proposal](Proposal) > [User needs](User-Needs)
- [Glossary](Glossary)
---e low likelihood, negligible impact,
or medium likelihood and marginal i
##### Project
::[PROJECT-NAME](Home)
##### Internal Release Number
::X.Y.Z
##### Related Documents
- [Proposal](Proposal) > Target Audience and Benefits
- [Project proposal](Proposal) > [User needs](User-Needs)
- [Glossary](Glossary)
---mpact.
##### Project
::[PROJECT-NAME](Home)
##### Internal Release Number
::X.Y.Z
##### Related Documents
- [Proposal](Proposal) > Target Audience and Benefits
- [Project proposal](Proposal) > [User needs](User-Needs)
- [Glossary](Glossary)
---
*TODO: You should update these list
##### Project
::[PROJECT-NAME](Home)
##### Internal Release Number
::X.Y.Z
##### Related Documents
- [Proposal](Proposal) > Target Audience and Benefits
- [Project proposal](Proposal) > [User needs](User-Needs)
- [Glossary](Glossary)
---s regularly. They should be reviewed
by customers and developers from ti
##### Project
::[PROJECT-NAME](Home)
##### Internal Release Number
::X.Y.Z
##### Related Documents
- [Proposal](Proposal) > Target Audience and Benefits
- [Project proposal](Proposal) > [User needs](User-Needs)
- [Glossary](Glossary)
---me to time.*
### General contingency plans ### General contingency plans
#### Catastrophic risks #### Catastrophic risks
::If a catastrophic risk occurs we will make an honest reassessment of ::If a catastrophic risk occurs we will make an honest reassessment of
@ -119,6 +56,7 @@ pretend everything is fine and hope that none of the
stakeholders notice. stakeholders notice.
#### Risks that consume development resources. #### Risks that consume development resources.
::The project has a fixed deadline. The requirements are prioritized. ::The project has a fixed deadline. The requirements are prioritized.
If we lose time, we will reduce project scope. If we lose time, we will reduce project scope.
@ -130,6 +68,7 @@ features, and meet with the customers to reconsider scope and
delivery date. delivery date.
#### ::OTHER RISK TYPE #### ::OTHER RISK TYPE
::OTHER CONTINGENCY PLAN ::OTHER CONTINGENCY PLAN
### Major risks ### Major risks
@ -151,122 +90,39 @@ 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 | ::Usability | The system as delivered may have low take-up because of poor usability. | Low | 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 |
::[PROJECT-NAME](Home)
##### Internal Release Number
::X.Y.Z
##### Related Documents
- [Proposal](Proposal) > Target Audience and Benefits
- [Project proposal](Proposal) > [User needs](User-Needs)
- [Glossary](Glossary)
--- |
| ::Usability | The system as
##### Project
::[PROJECT-NAME](Home)
##### Internal Release Number
::X.Y.Z
##### Related Documents
- [Proposal](Proposal) > Target Audience and Benefits
- [Project proposal](Proposal) > [User needs](User-Needs)
- [Glossary](Glossary)
--- delivered may have low take-up because of poor usability.
##### Project
::[PROJECT-NAME](Home)
##### Internal Release Number
::X.Y.Z
##### Related Documents
- [Proposal](Proposal) > Target Audience and Benefits
- [Project proposal](Proposal) > [User needs](User-Needs)
- [Glossary](Glossary)
--- | Low
##### Project
::[PROJECT-NAME](Home)
##### Internal Release Number
::X.Y.Z
##### Related Documents
- [Proposal](Proposal) > Target Audience and Benefits
- [Project proposal](Proposal) > [User needs](User-Needs)
- [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 |
| ::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 to new development. Contingency: request customer review of requirements. | Green | Project Manager |
##### Project | ::Process | Some developers 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 |
::[PROJECT-NAME](Home)
##### Internal Release Number
::X.Y.Z
##### Related Documents
- [Proposal](Proposal) > Target Audience and Benefits
- [Project proposal](Proposal) > [User needs](User-Needs)
- [Glossary](Glossary)
---o new development. Contingency: request customer review of requirements.
##### Project
::[PROJECT-NAME](Home)
##### Internal Release Number
::X.Y.Z
##### Related Documents
- [Proposal](Proposal) > Target Audience and Benefits
- [Project proposal](Proposal) > [User needs](User-Needs)
- [Glossary](Glossary)
--- | Green | P
##### Project
::[PROJECT-NAME](Home)
##### Internal Release Number
::X.Y.Z
##### Related Documents
- [Proposal](Proposal) > Target Audience and Benefits
- [Project proposal](Proposal) > [User needs](User-Needs)
- [Glossary](Glossary)
---roject Manager |
| ::Process | Some develope
##### Project
::[PROJECT-NAME](Home)
##### Internal Release Number
::X.Y.Z
##### Related Documents
- [Proposal](Proposal) > Target Audience and Benefits
- [Project proposal](Proposal) > [User needs](User-Needs)
- [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 |
| ::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 | PERSON-NAME | | ::RISK-NAME | 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
##### Red ##### Red
Active & impacting project Active & impacting project
##### Amber ##### Amber
Active but contained without impact to scope or delivery time. Active but contained without impact to scope or delivery time.
##### Green ##### Green
Not yet active Not yet active
### Risk Checklist ### Risk Checklist
#### Do the plans provide an indicator to detect each of the risks becoming active? #### Do the plans provide an indicator to detect each of the risks becoming active?
::Yes, if all activities are carried out as planned, we will know if any ::Yes, if all activities are carried out as planned, we will know if any
of the risks is becoming troublesome. of the risks is becoming troublesome.
::No, some risks could creep up on us. ::No, some risks could creep up on us.
#### Are the right "risk owners" assigned to monitor the risks? #### Are the right "risk owners" assigned to monitor the risks?
::Yes, for each risk the assigned owner can detect the indicator, can ::Yes, for each risk the assigned owner can detect the indicator, can
launch the contingency plan, and is the person who will suffer by launch the contingency plan, and is the person who will suffer by
the risk. the risk.
@ -275,6 +131,7 @@ the risk.
not have sufficient authority. not have sufficient authority.
#### Does each risk have a mitigation strategy, or is the risk acceptable? #### Does each risk have a mitigation strategy, or is the risk acceptable?
::Yes, we have plans to control each risk. ::Yes, we have plans to control each risk.
::Yes, we have plans to control some risks, and have accepted others. ::Yes, we have plans to control some risks, and have accepted others.
@ -282,12 +139,14 @@ not have sufficient authority.
::No, this plan leaves open several risks. ::No, this plan leaves open several risks.
#### Does each risk have a contingency plan? #### Does each risk have a contingency plan?
::Yes, most risks cost development time and the general plan applies, ::Yes, most risks cost development time and the general plan applies,
and for each of the others there is a contingency plan above. and for each of the others there is a contingency plan above.
::No, there are some risks we still have to plan for. ::No, there are some risks we still have to plan for.
#### Has this Risk Control Plan been communicated to the development team and other stakeholders? #### Has this Risk Control Plan been communicated to the development team and other stakeholders?
::Yes, this document is being posted to the project website. It will ::Yes, this document is being posted to the project website. It will
also be discussed at an early team meeting, and discussed with the also be discussed at an early team meeting, and discussed with the
customers before the commit to the project. Comments are welcome. customers before the commit to the project. Comments are welcome.
@ -295,9 +154,11 @@ customers before the commit to the project. Comments are welcome.
::No, our culture does not allow discussion of risks. ::No, our culture does not allow discussion of risks.
#### Is there a procedure in place for identifying new risks and reviewing the existing ones? #### Is there a procedure in place for identifying new risks and reviewing the existing ones?
::TBD ::TBD
#### In the light of these risks, is the project worth carrying out? #### In the light of these risks, is the project worth carrying out?
::Yes, it is a low risk project ::Yes, it is a low risk project
::No, other projects can deliver as much value at lower risk. ::No, other projects can deliver as much value at lower risk.
@ -307,7 +168,9 @@ we believe we have adequate plans here, considering the value that
the project could deliver. the project could deliver.
#### Is there an anonymous reporting channel, to allow developers to communicate concerns to senior management? #### Is there an anonymous reporting channel, to allow developers to communicate concerns to senior management?
::Yes
::No, everything depends on the alertness and strength of character of ::Yes
the project manager. RISKNAME
RISKNAME and strength of character of
RISKNAME
RISKNAME

5
SRS.md
View File

@ -1,18 +1,23 @@
##### Project ##### Project
::PROJECT-NAME ::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
- [Glossary](Glossary) - [Glossary](Glossary)
--- ---
**Process impact:** The SRS precisely defines the software product that **Process impact:** The SRS precisely defines the software product that

93
Status-Report.md
View File

@ -6,15 +6,19 @@ available.*
examples are given, you should select/edit only one.* examples are given, you should select/edit only one.*
##### Project ##### Project
::[PROJECT-NAME](Home) ::[PROJECT-NAME](Home)
##### Status Report Date: ##### Status Report Date
::YEAR/MONTH/DAY ::YEAR/MONTH/DAY
##### Next Internal Release Number: ##### Next Internal Release Number
::X.Y.Z ::X.Y.Z
##### Release Date: ##### Release Date
- ::Original estimate: YEAR/MONTH/DAY - ::Original estimate: YEAR/MONTH/DAY
- ::Current estimate: YEAR/MONTH/DAY - ::Current estimate: YEAR/MONTH/DAY
- ::Change Since Last Report: No change - ::Change Since Last Report: No change
@ -22,24 +26,29 @@ examples are given, you should select/edit only one.*
- ::Change Since Last Report: Saved 4 days - ::Change Since Last Report: Saved 4 days
##### Open Issues (needing development): ##### Open Issues (needing development):
- ::[17 defects](ISSUE-TRACKER-QUERY) - ::[17 defects](ISSUE-TRACKER-QUERY)
- ::[8 enhancements]() - ::[8 enhancements](#)
##### Resolved Issues (pending verification): ##### Resolved Issues (pending verification):
- ::[0 defects]()
- ::[2 enhancements]() - ::[0 defects](#)
- ::[2 enhancements](#)
##### Closed Issues: ##### Closed Issues:
- ::[34 defects]()
- ::[3 enhancements]() - ::[34 defects](#)
- ::[3 enhancements](#)
##### Resources used this period: ##### Resources used this period:
- ::PERSON-NAME: 18 hours. - ::PERSON-NAME: 18 hours.
- ::PERSON-NAME: 15 hours. - ::PERSON-NAME: 15 hours.
- ::PERSON-NAME: 10 hours. - ::PERSON-NAME: 10 hours.
- ::PERSON-NAME: 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.
- ::Low risk. Project on track. - ::Low risk. Project on track.
- ::Medium risk. Problems are being dealt with. - ::Medium risk. Problems are being dealt with.
@ -47,9 +56,11 @@ examples are given, you should select/edit only one.*
- ::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)
--- ---
**Process impact:** This helps keep stakeholders informed of project **Process impact:** This helps keep stakeholders informed of project
@ -67,71 +78,7 @@ words.
::Two major problems have been uncovered... ::Two major problems have been uncovered...
<!-- End Markdown content --> ::We are approximately 30% of the way through the project plan, and running about 2 days ahead of schedule...
</xmp>
<div w3-include-html="_words-of-wisdom.html"></div>
<div w3-include-html="_footer.html"></div>
<script>
w3IncludeHTML();
</script>
<script src="http://strapdownjs.com/v/0.2/strapdown.js"></script>
<!-- Include it AFTER strapdown -->
<script src="assets/strapdown/strapdown-topbar.min.js"></script>
<!-- Include it AFTER EVERYTHING -->
<script src="assets/logo.js"></script>
<script src="assets/themeswitcher.js"></script>
</body>
</html>
the way through the project plan, and
<!-- End Markdown content -->
</xmp>
<div w3-include-html="_words-of-wisdom.html"></div>
<div w3-include-html="_footer.html"></div>
<script>
w3IncludeHTML();
</script>
<script src="http://strapdownjs.com/v/0.2/strapdown.js"></script>
<!-- Include it AFTER strapdown -->
<script src="assets/strapdown/strapdown-topbar.min.js"></script>
<!-- Include it AFTER EVERYTHING -->
<script src="assets/logo.js"></script>
<script src="assets/themeswitcher.js"></script>
</body>
</html>
schedule...
<!-- End Markdown content -->
</xmp>
<div w3-include-html="_words-of-wisdom.html"></div>
<div w3-include-html="_footer.html"></div>
<script>
w3IncludeHTML();
</script>
<script src="http://strapdownjs.com/v/0.2/strapdown.js"></script>
<!-- Include it AFTER strapdown -->
<script src="assets/strapdown/strapdown-topbar.min.js"></script>
<!-- Include it AFTER EVERYTHING -->
<script src="assets/logo.js"></script>
<script src="assets/themeswitcher.js"></script>
</body>
</html>
::The reason for the change in estimated release date is... ::The reason for the change in estimated release date is...

39
Summary.md
View File

@ -4,19 +4,20 @@
from the project [Home](Home).* from the project [Home](Home).*
#### 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
### Status ### Status
*TODO: Briefly describe the status of this project. E.g., what phase are *TODO: Briefly describe the status of this project. E.g., what phase are you in? And, what is your next major milestone? Detailed project status is written in the status reports, not here.*
you in? And, what is your next major milestone? Detailed project status
is written in the status reports, not here.*
::We have completed our second beta release and are currently working on ::We have completed our second beta release and are currently working on
adding more of the functionality described in our product adding more of the functionality described in our product
@ -25,7 +26,8 @@ adding more of the functionality described in our product
::The next major milestone is a third beta release with nearly complete ::The next major milestone is a third beta release with nearly complete
functionality and a wider set of testers. functionality and a wider set of testers.
#### Status reports: #### Status reports
- ::[Status report 1](status-report.html) - ::[Status report 1](status-report.html)
- ::[Status report 2](status-report2.html) - ::[Status report 2](status-report2.html)
- ::Etc. - ::Etc.
@ -37,23 +39,27 @@ condensed from the [project plan](Project-Plan), [resource needs](Resource-Needs
and [legal issues](legal.html) documents.* and [legal issues](legal.html) documents.*
#### What are the deadlines for this project? #### What are the deadlines for this project?
- ::DATE: MILESTONE - ::DATE: MILESTONE
- ::DATE: MILESTONE - ::DATE: MILESTONE
- ::DATE: MILESTONE - ::DATE: MILESTONE
- ::DATE: RELEASE-NUMBER - ::DATE: RELEASE-NUMBER
#### Who is working on this project? #### Who is working on this project?
- ::100% PERSON-NAME - ::100% PERSON-NAME
- ::100% PERSON-NAME - ::100% PERSON-NAME
- ::75% PERSON-NAME - ::75% PERSON-NAME
- ::33% PERSON-NAME - ::33% PERSON-NAME
#### What capital resources are allocated to this project? #### What capital resources are allocated to this project?
- ::HARDWARE - ::HARDWARE
- ::SOFTWARE LICENSE - ::SOFTWARE LICENSE
- ::FACILITIES - ::FACILITIES
#### What are the main legal concerns for this project? #### What are the main legal concerns for this project?
- ::Intellectual property: DESCRIPTION - ::Intellectual property: DESCRIPTION
- ::Privacy and security: DESCRIPTION - ::Privacy and security: DESCRIPTION
- ::Potential harm: DESCRIPTION - ::Potential harm: DESCRIPTION
@ -67,16 +73,19 @@ condensed from the [user needs](User-Needs),
and [feature set](Feature-Set) documents.* and [feature set](Feature-Set) documents.*
#### Who are the project stakeholders? #### Who are the project stakeholders?
- ::PROJECT CHAMPION / EXECUTIVE SPONSOR - ::PROJECT CHAMPION / EXECUTIVE SPONSOR
- ::DEPARTMENTS WITHIN YOUR COMPANY - ::DEPARTMENTS WITHIN YOUR COMPANY
- ::CORPORATE PARTNERS - ::CORPORATE PARTNERS
- ::KEY CUSTOMERS - ::KEY CUSTOMERS
#### What user needs have you gathered? #### What user needs have you gathered?
- ::[User stories](LINK-TO-USER-STORIES) - ::[User stories](LINK-TO-USER-STORIES)
- ::[Interview notes](LINK-TO-INTERVIEW-NOTES) - ::[Interview notes](LINK-TO-INTERVIEW-NOTES)
#### What are the requirements specifications? #### What are the requirements specifications?
- ::[Use cases](LINK-TO-USE-CASES) - ::[Use cases](LINK-TO-USE-CASES)
- ::[Feature specifications](LINK-TO-FEATURE-SPECS) - ::[Feature specifications](LINK-TO-FEATURE-SPECS)
- ::[Environmental requirements](LINK-TO-ENV-REQ) - ::[Environmental requirements](LINK-TO-ENV-REQ)
@ -89,6 +98,7 @@ condensed from the [design](Design) template and associated
worksheets.* worksheets.*
#### What are your ranked design goals? #### What are your ranked design goals?
1. ::Correctness 1. ::Correctness
- ::This design correctly matches the - ::This design correctly matches the
given requirements. given requirements.
@ -118,6 +128,7 @@ worksheets.*
other resources. other resources.
#### Where are your design documents? #### Where are your design documents?
- ::[UML class diagram](LINK-TO-CLASS-DIAGRAM) - ::[UML class diagram](LINK-TO-CLASS-DIAGRAM)
- ::[UML class diagram](LINK-TO-CLASS-DIAGRAM) - ::[UML class diagram](LINK-TO-CLASS-DIAGRAM)
- ::[UML state diagram](LINK-TO-STATE-DIAGRAM) - ::[UML state diagram](LINK-TO-STATE-DIAGRAM)
@ -132,6 +143,7 @@ This is condensed from the [QA plan](QA-Plan), [test
suite](test-suite), and [test cases](test-cases.html) documents.* suite](test-suite), and [test cases](test-cases.html) documents.*
#### What are your ranked quality goals? #### What are your ranked quality goals?
1. ::Correctness 1. ::Correctness
2. ::Robustness 2. ::Robustness
3. ::Accuracy 3. ::Accuracy
@ -144,6 +156,7 @@ suite](test-suite), and [test cases](test-cases.html) documents.*
10. ::Maintainability 10. ::Maintainability
#### What QA activities will you use? #### What QA activities will you use?
- ::Preconditions and assertions - ::Preconditions and assertions
- ::Buddy reviews - ::Buddy reviews
- ::Review meetings - ::Review meetings
@ -151,28 +164,33 @@ suite](test-suite), and [test cases](test-cases.html) documents.*
- ::System testing - ::System testing
#### Where are the test cases? #### Where are the test cases?
- ::[Test case](LINK-TO-TEST-CASE) - ::[Test case](LINK-TO-TEST-CASE)
- ::[Test case](LINK-TO-TEST-CASE) - ::[Test case](LINK-TO-TEST-CASE)
- ::[Test case](LINK-TO-TEST-CASE) - ::[Test case](LINK-TO-TEST-CASE)
- ::[Test case](LINK-TO-TEST-CASE) - ::[Test case](LINK-TO-TEST-CASE)
### Packaging, Delivery, and Deployment ### Packaging, Delivery, and Deployment
Where is the release checklist or sign-off document? Where is the release checklist or sign-off document?
::[Release checklist](LINK-TO-RELEASE-CHECKLIST) ::[Release checklist](LINK-TO-RELEASE-CHECKLIST)
#### How is the product packaged and deployed? #### How is the product packaged and deployed?
- ::Packaging: DESCRIPTION - ::Packaging: DESCRIPTION
- ::Deployment: DESCRIPTION - ::Deployment: DESCRIPTION
- ::[Release notes](LINK-TO-RELEASE-NOTES) - ::[Release notes](LINK-TO-RELEASE-NOTES)
#### How is the product installed? #### How is the product installed?
- ::System requirements: DESCRIPTION - ::System requirements: DESCRIPTION
- ::STEP - ::STEP
- ::STEP - ::STEP
- ::STEP - ::STEP
### User Support ### User Support
Where is the user documentation? Where is the user documentation?
- ::[User guide](LINK-TO-USER-GUIDE) - ::[User guide](LINK-TO-USER-GUIDE)
@ -184,18 +202,23 @@ Where is the user documentation?
- ::Issue tracking: DESCRIPTION - ::Issue tracking: DESCRIPTION
### Glossary ### Glossary
*TODO: Define any technical terms that you use above, if a new member of *TODO: Define any technical terms that you use above, if a new member of
the team would not already know them. This is condensed from the the team would not already know them. This is condensed from the
[glossary](Glossary) documents.* [glossary](Glossary) documents.*
##### ::TECHNICAL TERM ##### ::TECHNICAL TERM 1
::DEFINITION ::DEFINITION
##### ::TECHNICAL TERM ##### ::TECHNICAL TERM 2
::DEFINITION ::DEFINITION
##### ::TECHNICAL TERM ##### ::TECHNICAL TERM 3
::DEFINITION ::DEFINITION
##### ::TECHNICAL TERM ##### ::TECHNICAL TERM 4
::DEFINITION ::DEFINITION

4
Target-and-Benefits.md
View File

@ -1,13 +1,17 @@
##### Project ##### Project
::[PROJECT-NAME](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)
--- ---
**Process impact:** This document helps identify potential customers and **Process impact:** This document helps identify potential customers and

51
Test-Case-Format.md
View File

@ -1,6 +1,8 @@
##### 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
--- ---
**Process impact:** This reference page documents the format of test **Process impact:** This reference page documents the format of test
@ -14,20 +16,26 @@ given to a new team member who would be able to quickly start to carry
out the tests and find defects. out the tests and find defects.
### unique-test-case-id: Test Case Title ### unique-test-case-id: Test Case Title
--- ---
#### Purpose
**Purpose:**
::Short sentence or two about the aspect of the system is being tested. If this gets too long, break the test case up or put more information into the feature descriptions. ::Short sentence or two about the aspect of the system is being tested. If this gets too long, break the test case up or put more information into the feature descriptions.
#### Prereq **Prerequisite:**
Assumptions that must be met before the test case can be run. E.g., &quot;logged in&quot;, &quot;guest login allowed&quot;, &quot;user testuser exists&quot;.
Assumptions that must be met before the test case can be run. E.g., &quot;logged in&quot;, &quot;guest login allowed&quot;, &quot;user test-user exists&quot;.
**Test Data:**
#### Test Data
List of variables and their possible values used in the test case. You can list specific values or describe value ranges. The test case should be performed once for each *combination* of values. These values are written in set notation, one per line. E.g.: List of variables and their possible values used in the test case. You can list specific values or describe value ranges. The test case should be performed once for each *combination* of values. These values are written in set notation, one per line. E.g.:
- ::loginID = {Valid loginID, invalid loginID, valid email, invalid email, empty} - ::loginID = {Valid loginID, invalid loginID, valid email, invalid email, empty}
- ::password = {valid, invalid, empty} - ::password = {valid, invalid, empty}
#### Steps **Steps:**
Steps to carry out the test. See step formating rules below. Steps to carry out the test. See step formating rules below.
- ::visit LoginPage - ::visit LoginPage
@ -40,7 +48,7 @@ Steps to carry out the test. See step formating rules below.
- ::see PersonalPage - ::see PersonalPage
- ::verify that welcome message is correct username - ::verify that welcome message is correct username
#### Notes and Questions: **Notes and Questions:**
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
@ -50,55 +58,65 @@ Steps to carry out the test. See step formating rules below.
Each step can be written very tersely using the following keywords: Each step can be written very tersely using the following keywords:
#### ::login \[as ROLE-OR-USER\] #### ::login \[as ROLE-OR-USER\]
::Log into the system with a given user or a user of the given type. ::Log into the system with a given user or a user of the given type.
Usually only stated explicitly when the test case depends on the Usually only stated explicitly when the test case depends on the
permissions of a particular role or involves a workflow between permissions of a particular role or involves a workflow between
different users. different users.
#### ::visit LOCATION #### ::visit LOCATION
::Visit a page or screen. For web applications, LOCATION may be ::Visit a page or screen. For web applications, LOCATION may be
a hyperlink. The location should be a well-known starting point a hyperlink. The location should be a well-known starting point
(e.g., the Login screen), drilling down to specific pages should be (e.g., the Login screen), drilling down to specific pages should be
part of the test. part of the test.
#### ::enter FIELD-NAME \[as VALUE\] \[in SCREEN-LOCATION\] #### ::enter FIELD-NAME \[as VALUE\] \[in SCREEN-LOCATION\]
::Fill in a named form field. VALUE can be a literal value or the name ::Fill in a named form field. VALUE can be a literal value or the name
of a variable defined in the "Test Data" section. The FIELD-NAME of a variable defined in the "Test Data" section. The FIELD-NAME
itself can be a variable name when the UI field for that value is itself can be a variable name when the UI field for that value is
clear from context, e.g., "enter password". clear from context, e.g., "enter password".
#### ::enter FIELDS #### ::enter FIELDS
::Fill in all fields in a form when their values are clear from ::Fill in all fields in a form when their values are clear from
context or when their specific values are not important in this context or when their specific values are not important in this
test case. test case.
#### ::click "LINK-LABEL" \[in SCREEN-LOCATION\] #### ::click "LINK-LABEL" \[in SCREEN-LOCATION\]
::Follow a labeled link or press a button. The screen location can be ::Follow a labeled link or press a button. The screen location can be
a predefined panel name or English phrase. Predefined panel names a predefined panel name or English phrase. Predefined panel names
are based on GUI class names, master template names, or titles of are based on GUI class names, master template names, or titles of
boxes on the page. boxes on the page.
#### ::click BUTTON-NAME \[in SCREEN-LOCATION\] #### ::click BUTTON-NAME \[in SCREEN-LOCATION\]
::Press a named button. This step should always be followed by a "see" ::Press a named button. This step should always be followed by a "see"
step to check the results. step to check the results.
#### ::see SCREEN-OR-PAGE #### ::see SCREEN-OR-PAGE
::The tester should see the named GUI screen or web page. The general ::The tester should see the named GUI screen or web page. The general
correctness of the page should be testable based on the correctness of the page should be testable based on the
feature description. feature description.
#### ::verify CONDITION #### ::verify CONDITION
::The tester should see that the condition has been satisfied. This ::The tester should see that the condition has been satisfied. This
type of step usually follows a "see" step at the end of the type of step usually follows a "see" step at the end of the
test case. test case.
#### ::verify CONTENT \[is VALUE\] #### ::verify CONTENT \[is VALUE\]
::The tester should see the named content on the current page, the ::The tester should see the named content on the current page, the
correct values should be clear from the test data, or correct values should be clear from the test data, or
given explicitly. This type of step usually follows a "see" step at given explicitly. This type of step usually follows a "see" step at
the end of the test case. the end of the test case.
#### ::perform TEST-CASE-NAME #### ::perform TEST-CASE-NAME
::This is like a subroutine call. The tester should perform all the ::This is like a subroutine call. The tester should perform all the
steps of the named test case and then continue on to the next step steps of the named test case and then continue on to the next step
of this test case. of this test case.
@ -108,24 +126,3 @@ expected output is very clear. A test case can have multiple verify
steps in the middle or at the end. Having multiple verify steps can be steps in the middle or at the end. Having multiple verify steps can be
useful if you want a smaller number of long tests rather than a large useful if you want a smaller number of long tests rather than a large
number of short tests.* number of short tests.*
<!-- End Markdown content -->
</xmp>
<div w3-include-html="_words-of-wisdom.html"></div>
<div w3-include-html="_footer.html"></div>
<script>
w3IncludeHTML();
</script>
<script src="http://strapdownjs.com/v/0.2/strapdown.js"></script>
<!-- Include it AFTER strapdown -->
<script src="assets/strapdown/strapdown-topbar.min.js"></script>
<!-- Include it AFTER EVERYTHING -->
<script src="assets/logo.js"></script>
<script src="assets/themeswitcher.js"></script>
</body>
</html>

145
Test-Cases.md
View File

@ -1,34 +1,42 @@
##### Project ##### Project
::[PROJECT-NAME](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
::LINKS TO OTHER DOCUMENTS ::LINKS TO OTHER DOCUMENTS
--- ---
### login-1: Normal User Login ### login-1: Normal User Login
#### Purpose: **Purpose:**
::Test that users can log in with the proper username or ::Test that users can log in with the proper username or
email address and their password. email address and their password.
#### Prereq: **Prerequisite:**
::User is not already logged in. ::User is not already logged in.
::User testuser exists, and account is in good standing. ::User test-user exists, and account is in good standing.
#### Test Data: **Test Data:**
::usernameOrEmail = {testuser, bogususer, testuser@nospam.com,
::usernameOrEmail = {test-user, bogus-user, test-user@nospam.com,
test@user@nospam.com, empty} test@user@nospam.com, empty}
::password = {valid, invalid, empty} ::password = {valid, invalid, empty}
#### Steps: **Steps:**
::Steps to carry out the test. See step formating rules below. ::Steps to carry out the test. See step formating rules below.
- ::visit LoginPage - ::visit LoginPage
@ -41,28 +49,33 @@ test@user@nospam.com, empty}
- ::see PersonalPage - ::see PersonalPage
- ::verify that welcome message is correct username - ::verify that welcome message is correct username
#### Notes and Questions: **Notes and Questions:**
- ::This assumes that user has not agreed to terms-of-use already. - ::This assumes that user has not agreed to terms-of-use already.
- ::Does this work without browser cookies? - ::Does this work without browser cookies?
--- ---
### login-2: Locked-out User Login ### login-2: Locked-out User Login
#### Purpose: **Purpose:**
::Test that a user who has been locked out by a moderator, cannot ::Test that a user who has been locked out by a moderator, cannot
log in, They should see a message indicating that they were locked log in, They should see a message indicating that they were locked
out. out.
#### Prereq: **Prerequisite:**
::User is not already logged in. ::User is not already logged in.
::User testuser2 exists, and has been locked out ::User test-user2 exists, and has been locked out
**Test Data:**
#### Test Data: ::usernameOrEmail = {test-user2, test-user2@nospam.com}
::usernameOrEmail = {testuser2, testuser2@nospam.com}
::password = {valid} ::password = {valid}
#### Steps: **Steps:**
::Steps to carry out the test. See step formating rules below. ::Steps to carry out the test. See step formating rules below.
- ::visit LoginPage - ::visit LoginPage
@ -72,23 +85,26 @@ out.
- ::see LoginPage - ::see LoginPage
- ::verify warning message is the locked-out message - ::verify warning message is the locked-out message
#### Notes and Questions: **Notes and Questions:**
- ::Does this work without browser cookies? - ::Does this work without browser cookies?
### unique-test-case-id1: Test Case Title ### unique-test-case-id1: Test Case Title
#### Purpose: **Purpose:**
::Short sentence or two about the aspect of the system is ::Short sentence or two about the aspect of the system is
being tested. If this gets too long, break the test case being tested. If this gets too long, break the test case
up or put more information into the feature descriptions. up or put more information into the feature descriptions.
#### Prereq: **Prerequisite:**
::Assumptions that must be met before the test case can be run. ::Assumptions that must be met before the test case can be run.
E.g., &quot;logged in&quot;, &quot;guest login allowed&quot;, E.g., &quot;logged in&quot;, &quot;guest login allowed&quot;,
&quot;user testuser exists&quot;. &quot;user test-user exists&quot;.
**Test Data:**
#### Test Data:
::List of variables and their possible values used in the test case. ::List of variables and their possible values used in the test case.
You can list specific values or describe value ranges. The test case You can list specific values or describe value ranges. The test case
should be performed once for each *combination* of values. These should be performed once for each *combination* of values. These
@ -98,7 +114,8 @@ values are written in set notation, one per line. E.g.:
email, empty} email, empty}
- password = {valid, invalid, empty} - password = {valid, invalid, empty}
#### Steps: **Steps:**
::Steps to carry out the test. See step formating rules below. ::Steps to carry out the test. See step formating rules below.
- ::visit LoginPage - ::visit LoginPage
@ -111,24 +128,29 @@ values are written in set notation, one per line. E.g.:
- ::see PersonalPage - ::see PersonalPage
- ::verify that welcome message is correct username - ::verify that welcome message is correct username
#### Notes and Questions: **Notes and Questions:**
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
--- ---
### unique-test-case-id2: Test Case Title ### unique-test-case-id2: Test Case Title
#### Purpose: **Purpose:**
::Short sentence or two about the aspect of the system is ::Short sentence or two about the aspect of the system is
being tested. If this gets too long, break the test case being tested. If this gets too long, break the test case
up or put more information into the feature descriptions. up or put more information into the feature descriptions.
#### Prereq: **Prerequisite:**
::Assumptions that must be met before the test case can be run. ::Assumptions that must be met before the test case can be run.
E.g., &quot;logged in&quot;, &quot;guest login allowed&quot;, E.g., &quot;logged in&quot;, &quot;guest login allowed&quot;,
&quot;user testuser exists&quot;. &quot;user test-user exists&quot;.
**Test Data:**
#### Test Data:
::List of variables and their possible values used in the test case. ::List of variables and their possible values used in the test case.
You can list specific values or describe value ranges. The test case You can list specific values or describe value ranges. The test case
should be performed once for each *combination* of values. These should be performed once for each *combination* of values. These
@ -138,7 +160,8 @@ values are written in set notation, one per line. E.g.:
email, empty} email, empty}
- ::password = {valid, invalid, empty} - ::password = {valid, invalid, empty}
#### Steps: **Steps:**
::Steps to carry out the test. See step formating rules below. ::Steps to carry out the test. See step formating rules below.
- ::visit LoginPage - ::visit LoginPage
@ -151,23 +174,27 @@ values are written in set notation, one per line. E.g.:
- ::see PersonalPage - ::see PersonalPage
- ::verify that welcome message is correct username - ::verify that welcome message is correct username
#### Notes and Questions: **Notes and Questions:**
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
### unique-test-case-id3: Test Case Title ### unique-test-case-id3: Test Case Title
#### Purpose: **Purpose:**
::Short sentence or two about the aspect of the system is ::Short sentence or two about the aspect of the system is
being tested. If this gets too long, break the test case being tested. If this gets too long, break the test case
up or put more information into the feature descriptions. up or put more information into the feature descriptions.
#### Prereq: **Prerequisite:**
::Assumptions that must be met before the test case can be run. ::Assumptions that must be met before the test case can be run.
E.g., &quot;logged in&quot;, &quot;guest login allowed&quot;, E.g., &quot;logged in&quot;, &quot;guest login allowed&quot;,
&quot;user testuser exists&quot;. &quot;user test-user exists&quot;.
**Test Data:**
#### Test Data:
::List of variables and their possible values used in the test case. ::List of variables and their possible values used in the test case.
You can list specific values or describe value ranges. The test case You can list specific values or describe value ranges. The test case
should be performed once for each *combination* of values. These should be performed once for each *combination* of values. These
@ -177,7 +204,8 @@ values are written in set notation, one per line. E.g.:
email, empty} email, empty}
- ::password = {valid, invalid, empty} - ::password = {valid, invalid, empty}
#### Steps: **Steps:**
::Steps to carry out the test. See step formating rules below. ::Steps to carry out the test. See step formating rules below.
- ::visit LoginPage - ::visit LoginPage
@ -190,24 +218,29 @@ values are written in set notation, one per line. E.g.:
- ::see PersonalPage - ::see PersonalPage
- ::verify that welcome message is correct username - ::verify that welcome message is correct username
#### Notes and Questions: **Notes and Questions:**
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
--- ---
### unique-test-case-id4: Test Case Title ### unique-test-case-id4: Test Case Title
#### Purpose: **Purpose:**
::Short sentence or two about the aspect of the system is ::Short sentence or two about the aspect of the system is
being tested. If this gets too long, break the test case being tested. If this gets too long, break the test case
up or put more information into the feature descriptions. up or put more information into the feature descriptions.
#### Prereq: **Prerequisite:**
::Assumptions that must be met before the test case can be run. ::Assumptions that must be met before the test case can be run.
E.g., &quot;logged in&quot;, &quot;guest login allowed&quot;, E.g., &quot;logged in&quot;, &quot;guest login allowed&quot;,
&quot;user testuser exists&quot;. &quot;user test-user exists&quot;.
**Test Data:**
#### Test Data:
::List of variables and their possible values used in the test case. ::List of variables and their possible values used in the test case.
You can list specific values or describe value ranges. The test case You can list specific values or describe value ranges. The test case
should be performed once for each *combination* of values. These should be performed once for each *combination* of values. These
@ -217,7 +250,8 @@ values are written in set notation, one per line. E.g.:
email, empty} email, empty}
- ::password = {valid, invalid, empty} - ::password = {valid, invalid, empty}
#### Steps: **Steps:**
::Steps to carry out the test. See step formating rules below. ::Steps to carry out the test. See step formating rules below.
- ::visit LoginPage - ::visit LoginPage
@ -230,23 +264,27 @@ values are written in set notation, one per line. E.g.:
- ::see PersonalPage - ::see PersonalPage
- ::verify that welcome message is correct username - ::verify that welcome message is correct username
#### Notes and Questions: **Notes and Questions:**
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
### unique-test-case-id5: Test Case Title ### unique-test-case-id5: Test Case Title
#### Purpose: **Purpose:**
::Short sentence or two about the aspect of the system is ::Short sentence or two about the aspect of the system is
being tested. If this gets too long, break the test case being tested. If this gets too long, break the test case
up or put more information into the feature descriptions. up or put more information into the feature descriptions.
#### Prereq: **Prerequisite:**
::Assumptions that must be met before the test case can be run. ::Assumptions that must be met before the test case can be run.
E.g., &quot;logged in&quot;, &quot;guest login allowed&quot;, E.g., &quot;logged in&quot;, &quot;guest login allowed&quot;,
&quot;user testuser exists&quot;. &quot;user test-user exists&quot;.
**Test Data:**
#### Test Data:
::List of variables and their possible values used in the test case. ::List of variables and their possible values used in the test case.
You can list specific values or describe value ranges. The test case You can list specific values or describe value ranges. The test case
should be performed once for each *combination* of values. These should be performed once for each *combination* of values. These
@ -256,7 +294,8 @@ values are written in set notation, one per line. E.g.:
email, empty} email, empty}
- ::password = {valid, invalid, empty} - ::password = {valid, invalid, empty}
#### Steps: **Steps:**
::Steps to carry out the test. See step formating rules below. ::Steps to carry out the test. See step formating rules below.
- ::visit LoginPage - ::visit LoginPage
@ -269,24 +308,28 @@ values are written in set notation, one per line. E.g.:
- ::see PersonalPage - ::see PersonalPage
- ::verify that welcome message is correct username - ::verify that welcome message is correct username
#### Notes and Questions: **Notes and Questions:**
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
--- ---
### unique-test-case-id6: Test Case Title ### unique-test-case-id6: Test Case Title
#### Purpose: **Purpose:**
::Short sentence or two about the aspect of the system is ::Short sentence or two about the aspect of the system is
being tested. If this gets too long, break the test case being tested. If this gets too long, break the test case
up or put more information into the feature descriptions. up or put more information into the feature descriptions.
#### Prereq: **Prerequisite:**
::Assumptions that must be met before the test case can be run. ::Assumptions that must be met before the test case can be run.
E.g., &quot;logged in&quot;, &quot;guest login allowed&quot;, E.g., &quot;logged in&quot;, &quot;guest login allowed&quot;,
&quot;user testuser exists&quot;. &quot;user test-user exists&quot;.
**Test Data:**
#### Test Data:
::List of variables and their possible values used in the test case. ::List of variables and their possible values used in the test case.
You can list specific values or describe value ranges. The test case You can list specific values or describe value ranges. The test case
should be performed once for each *combination* of values. These should be performed once for each *combination* of values. These
@ -296,7 +339,8 @@ values are written in set notation, one per line. E.g.:
email, empty} email, empty}
- ::password = {valid, invalid, empty} - ::password = {valid, invalid, empty}
#### Steps: **Steps:**
::Steps to carry out the test. See step formating rules below. ::Steps to carry out the test. See step formating rules below.
- ::visit LoginPage - ::visit LoginPage
@ -309,6 +353,7 @@ values are written in set notation, one per line. E.g.:
- ::see PersonalPage - ::see PersonalPage
- ::verify that welcome message is correct username - ::verify that welcome message is correct username
#### Notes and Questions: **Notes and Questions:**
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION

5
Test-Run-Suite.md
View File

@ -1,14 +1,18 @@
##### Project ##### Project
::[PROJECT-NAME](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
- ::LINKS TO OTHER DOCUMENTS - ::LINKS TO OTHER DOCUMENTS
--- ---
**Process impact:** This is a test run log for manual system testing. A **Process impact:** This is a test run log for manual system testing. A
@ -19,6 +23,7 @@ degree to which the system has been tested helps to assess progress,
assess risk, and focus ongoing testing efforts. assess risk, and focus ongoing testing efforts.
*TODO: *TODO:
- Review the [target audience](Target-and-Benefits), - Review the [target audience](Target-and-Benefits),
[environmental requirements](SRS#environmental), and [possible [environmental requirements](SRS#environmental), and [possible
deployments](Design-Architecturel#deployment) to understand the deployments](Design-Architecturel#deployment) to understand the

42
Test-Runs.md
View File

@ -1,14 +1,18 @@
##### Project ##### Project
::[PROJECT-NAME](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
- ::LINKS TO OTHER DOCUMENTS - ::LINKS TO OTHER DOCUMENTS
--- ---
*TODO: Use this file to record the results of each test run. Or, use your *TODO: Use this file to record the results of each test run. Or, use your
@ -28,11 +32,7 @@ issue tracking tool to plan and track test runs.*
::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT ::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT
**Test Description** **Test Description:**
::Performed all [manual system tests](Test-Cases).
**Test Run Results:**
::Pending | Passed | FAILED ::Pending | Passed | FAILED
@ -40,6 +40,7 @@ issue tracking tool to plan and track test runs.*
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
--- ---
### TR-01: Test Run ### TR-01: Test Run
@ -56,11 +57,7 @@ issue tracking tool to plan and track test runs.*
::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT ::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT
**Test Description** **Test Description:**
::Performed all [manual system tests](Test-Cases).
**Test Run Results:**
::Pending | Passed | FAILED ::Pending | Passed | FAILED
@ -68,6 +65,7 @@ issue tracking tool to plan and track test runs.*
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
--- ---
### TR-02: Test Run ### TR-02: Test Run
@ -84,7 +82,7 @@ issue tracking tool to plan and track test runs.*
::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT ::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT
**Test Description** **Test Description:**
::Performed all [manual system tests](Test-Cases). ::Performed all [manual system tests](Test-Cases).
@ -96,6 +94,7 @@ issue tracking tool to plan and track test runs.*
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
--- ---
### TR-03: Test Run ### TR-03: Test Run
@ -112,7 +111,7 @@ issue tracking tool to plan and track test runs.*
::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT ::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT
**Test Description** **Test Description:**
::Performed all [manual system tests](Test-Cases). ::Performed all [manual system tests](Test-Cases).
@ -124,6 +123,7 @@ issue tracking tool to plan and track test runs.*
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
--- ---
### TR-10: Test Run ### TR-10: Test Run
@ -140,7 +140,7 @@ issue tracking tool to plan and track test runs.*
::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT ::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT
**Test Description** **Test Description:**
::Performed all [manual system tests](Test-Cases). ::Performed all [manual system tests](Test-Cases).
@ -152,6 +152,7 @@ issue tracking tool to plan and track test runs.*
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
--- ---
### TR-11: Test Run ### TR-11: Test Run
@ -168,7 +169,7 @@ issue tracking tool to plan and track test runs.*
::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT ::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT
**Test Description** **Test Description:**
::Performed all [manual system tests](Test-Cases). ::Performed all [manual system tests](Test-Cases).
@ -180,6 +181,7 @@ issue tracking tool to plan and track test runs.*
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
--- ---
### TR-12: Test Run ### TR-12: Test Run
@ -196,7 +198,7 @@ issue tracking tool to plan and track test runs.*
::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT ::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT
**Test Description** **Test Description:**
::Performed all [manual system tests](Test-Cases). ::Performed all [manual system tests](Test-Cases).
@ -208,6 +210,7 @@ issue tracking tool to plan and track test runs.*
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
--- ---
### TR-13: Test Run ### TR-13: Test Run
@ -224,7 +227,7 @@ issue tracking tool to plan and track test runs.*
::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT ::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT
**Test Description** **Test Description:**
::Performed all [manual system tests](Test-Cases). ::Performed all [manual system tests](Test-Cases).
@ -236,6 +239,7 @@ issue tracking tool to plan and track test runs.*
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
--- ---
### TR-20: Test Run ### TR-20: Test Run
@ -252,7 +256,7 @@ issue tracking tool to plan and track test runs.*
::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT ::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT
**Test Description** **Test Description:**
::Performed all [manual system tests](Test-Cases). ::Performed all [manual system tests](Test-Cases).
@ -264,6 +268,7 @@ issue tracking tool to plan and track test runs.*
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
--- ---
### TR-21: Test Run ### TR-21: Test Run
@ -280,7 +285,7 @@ issue tracking tool to plan and track test runs.*
::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT ::NAME-OF-SERVER | DESCRIPTION-OF-TEST-ENVIRONMENT
**Test Description** **Test Description:**
::Performed all [manual system tests](Test-Cases). ::Performed all [manual system tests](Test-Cases).
@ -292,4 +297,5 @@ issue tracking tool to plan and track test runs.*
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
--- ---

4
Test-Suite.md
View File

@ -1,14 +1,18 @@
##### Project ##### Project
::[PROJECT-NAME](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
- ::LINKS TO OTHER DOCUMENTS - ::LINKS TO OTHER DOCUMENTS
--- ---
**Process impact:** This is a test suite for manual system testing. It **Process impact:** This is a test suite for manual system testing. It

23
Use-Case-Format.md
View File

@ -1,6 +1,8 @@
##### Related Documents ##### Related Documents
- [SRS](SRS) > [Use Case Suite](Use-Case-Suite) > Use Case Format - [SRS](SRS) > [Use Case Suite](Use-Case-Suite) > Use Case Format
--- ---
**Process impact:** This reference page documents the format of use **Process impact:** This reference page documents the format of use
@ -13,26 +15,28 @@ document. Anything you mention here will apply to all use cases in that
file.* file.*
--- ---
### Aspects common to all use cases ### Aspects common to all use cases
#### 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 &quot;see&quot; indicate that System has presented a new screen. - ::Items beginning with &quot;see&quot; indicate that System has presented a new screen.
#### Stakeholders: **Stakeholders:**
::The user who is entering the data, and those who will read it ::The user who is entering the data, and those who will read it
#### Prereq: **Prerequisite:**
::Project is set up ::Project is set up
*TODO: Copy and paste this use case template as many times as needed in *TODO: Copy and paste this use case template as many times as needed in
your [Use Cases](Use-Cases) document. Only use those fields that your [Use Cases](Use-Cases) document. Only use those fields that
are not the same as the default for all use cases.* are not the same as the default for all use cases.*
--- ---
### UC-00: USE CASE NAME ### UC-00: USE CASE NAME
**Summary:** **Summary:**
@ -55,7 +59,7 @@ are not the same as the default for all use cases.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -75,7 +79,7 @@ are not the same as the default for all use cases.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -83,22 +87,26 @@ are not the same as the default for all use cases.*
- ::QUESTION - ::QUESTION
--- ---
### Format of Use Case Steps ### Format of Use Case Steps
Try to start each step with one of these action words: Try to start each step with one of these action words:
#### login \[as ROLE or USER\] #### login \[as ROLE or USER\]
Log into the system with a given user or a user of the given type. Log into the system with a given user or a user of the given type.
Usually usually only stated explicitly when the test case involves a Usually usually only stated explicitly when the test case involves a
workflow between different users. workflow between different users.
#### visit LOCATION #### visit LOCATION
Visit a page or GUI window. State the user's intention, don't say Visit a page or GUI window. State the user's intention, don't say
too much about UI choices that could change later. E.g., WRONG: too much about UI choices that could change later. E.g., WRONG:
"Press the 'Advanced...' button on the File | Page Setup dialog". "Press the 'Advanced...' button on the File | Page Setup dialog".
RIGHT: "Visit the page margin configuration dialog". RIGHT: "Visit the page margin configuration dialog".
#### enter INFORMATION #### enter INFORMATION
Fill in specific information. Try to state the information in Fill in specific information. Try to state the information in
some detail. E.g., WRONG: "Enter customer information." RIGHT: some detail. E.g., WRONG: "Enter customer information." RIGHT:
"Enter customer shipping address and discount code." Don't commit to "Enter customer shipping address and discount code." Don't commit to
@ -106,6 +114,7 @@ details of a particular UI, i.e., don't name specific UI fields that
might change later. might change later.
#### COMMAND #### COMMAND
Describe a command that the user can tell the system to do. State Describe a command that the user can tell the system to do. State
the user's intent, not the label on a particular UI widget. This the user's intent, not the label on a particular UI widget. This
will usually be followed by a "see" step where the user sees a will usually be followed by a "see" step where the user sees a
@ -113,6 +122,7 @@ confirmation of their action. E.g., WRONG: "Control-P, OK". RIGHT:
"Print the current document with default settings". "Print the current document with default settings".
#### see CONTENT #### see CONTENT
The user should see the specified information on the currently The user should see the specified information on the currently
presented web page or GUI window. Try to be specific about the presented web page or GUI window. Try to be specific about the
information that is seen, but try not to refer to specific information that is seen, but try not to refer to specific
@ -121,6 +131,7 @@ supposed to notice on that page?) RIGHT: "see list of users with the
newly added user in the list". newly added user in the list".
#### perform USE-CASE-NAME #### perform USE-CASE-NAME
This is like a subroutine call. The user will do all the steps of This is like a subroutine call. The user will do all the steps of
the named use case and then continue on with the next step of this the named use case and then continue on with the next step of this
use case. use case.

7
Use-Case-Suite.md
View File

@ -1,10 +1,13 @@
##### Project ##### Project
::[PROJECT-NAME](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)
@ -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 use case suite is simply a table of contents for **Process impact:** A use case suite is simply a table of contents for
@ -53,8 +57,7 @@ cases, explicitly mark it "N/A". Otherwise, mark it "TODO".*
- ::[UC-20](Use-Cases#UC-20) Enroll in course - ::[UC-20](Use-Cases#UC-20) Enroll in course
- ::[UC-21](Use-Cases#UC-21) Drop course - ::[UC-21](Use-Cases#UC-21) Drop course
- ::Scalability and availability - ::Scalability and availability
- ::N/A: These features are completely automated and internal, users - ::N/A: These features are completely automated and internal, users never interact with them
never interact with them
- ::Facilities management - ::Facilities management
- ::[UC-30](Use-Cases#UC-30) View room description - ::[UC-30](Use-Cases#UC-30) View room description
- ::[UC-31](Use-Cases#UC-31) Assign course to room - ::[UC-31](Use-Cases#UC-31) Assign course to room

117
Use-Cases.md
View File

@ -1,16 +1,20 @@
##### Project ##### Project
::PROJECT-NAME ::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
@ -30,7 +34,7 @@ note it's specific value to replace or add to the default.*
::Project Owners and other members ::Project Owners and other members
**Prereq:** **Prerequisite:**
::User is logged in ::User is logged in
@ -47,6 +51,7 @@ cases first and come back to less important ones later.*
[guidelines for writing use cases](Use-Case-Format#further-information).* [guidelines for writing use cases](Use-Case-Format#further-information).*
--- ---
### UC-00: Configure the site ### UC-00: Configure the site
**Summary:** **Summary:**
@ -74,18 +79,18 @@ cases first and come back to less important ones later.*
5. ::confirm changes 5. ::confirm changes
6. ::see SiteConfiguration page again, with updated values 6. ::see SiteConfiguration page again, with updated values
**Alternative Scenario Extensions:** **Alternative Scenario Extensions:**
- ::If the timezone abbreviation is incorrect, an error message will be displayed and no changes will be made. - ::If the timezone abbreviation is incorrect, an error message will be displayed and no changes will be made.
**Notes and Questions** **Notes and Questions:**
- ::How will administrators know the right timezone abbreviation? - ::How will administrators know the right timezone abbreviation?
- They would know it if they live in that timezone. Maybe we could - They would know it if they live in that timezone. Maybe we could
provide a drop-down list of all choices, but each would need some explanation. provide a drop-down list of all choices, but each would need some explanation.
--- ---
### UC-01: Register as a new user ### UC-01: Register as a new user
**Summary:** **Summary:**
@ -114,12 +119,13 @@ cases first and come back to less important ones later.*
- ::If the username is taken, then the system will suggest an available username based on the user's email address and/or real name. - ::If the username is taken, then the system will suggest an available username based on the user's email address and/or real name.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::QUESTION - ::QUESTION
--- ---
### UC-02: Request new password ### UC-02: Request new password
**Summary:** **Summary:**
@ -138,11 +144,12 @@ cases first and come back to less important ones later.*
- ::TODO - ::TODO
**Notes and Questions** **Notes and Questions:**
- ::Alternatively, we could use password hints. - ::Alternatively, we could use password hints.
--- ---
### UC-03: Edit user profile ### UC-03: Edit user profile
** Summary:** ** Summary:**
@ -162,6 +169,7 @@ cases first and come back to less important ones later.*
- ::TODO - ::TODO
--- ---
### UC-04: View user profile ### UC-04: View user profile
**Summary:** **Summary:**
@ -185,6 +193,7 @@ cases first and come back to less important ones later.*
- ::TODO - ::TODO
--- ---
### UC-10: Create course ### UC-10: Create course
**Summary:** **Summary:**
@ -201,7 +210,7 @@ cases first and come back to less important ones later.*
**Direct Actors:** **Direct Actors:**
::Admin: Web-site adminisator ::Admin: Web-site administrator
**Main Success Scenario:** **Main Success Scenario:**
@ -212,6 +221,7 @@ cases first and come back to less important ones later.*
- ::see course list with new course added - ::see course list with new course added
--- ---
### UC-11: View catalog description ### UC-11: View catalog description
**Summary:** **Summary:**
@ -233,13 +243,12 @@ cases first and come back to less important ones later.*
- ::see course description in pop-up window - ::see course description in pop-up window
- ::close pop-up window to continue using application - ::close pop-up window to continue using application
**Notes and Questions:**
**Notes and Questions**
- ::How do we accommodate users that configure their browsers to block pop-ups? - ::How do we accommodate users that configure their browsers to block pop-ups?
--- ---
### UC-20: Enroll in course ### UC-20: Enroll in course
**Summary:** **Summary:**
@ -270,6 +279,7 @@ cases first and come back to less important ones later.*
- ::Course capacity and number of students currently waiting should be shown so that students may choose the section that they are most likely to be able to get into. - ::Course capacity and number of students currently waiting should be shown so that students may choose the section that they are most likely to be able to get into.
--- ---
### UC-21: Drop a course ### UC-21: Drop a course
**Summary:** **Summary:**
@ -293,12 +303,13 @@ cases first and come back to less important ones later.*
- ::confirm choice - ::confirm choice
- ::see revised list of currently enrolled courses - ::see revised list of currently enrolled courses
**Notes and Questions** **Notes and Questions:**
- ::Only one course can be dropped at a time. There is no need to allow students to quickly drop more than one course. - ::Only one course can be dropped at a time. There is no need to allow students to quickly drop more than one course.
- ::It would be nice to offer an atomic "switch sections" operation that drops and adds another, or does nothing. - ::It would be nice to offer an atomic "switch sections" operation that drops and adds another, or does nothing.
--- ---
### UC-30: View room description ### UC-30: View room description
**Summary:** **Summary:**
@ -318,6 +329,7 @@ cases first and come back to less important ones later.*
- ::TODO - ::TODO
--- ---
### UC-31: Assign course to room ### UC-31: Assign course to room
**Summary:** **Summary:**
@ -339,6 +351,7 @@ cases first and come back to less important ones later.*
- ::STEP - ::STEP
--- ---
### UC-40: USE CASE NAME ### UC-40: USE CASE NAME
**Summary:** **Summary:**
@ -361,7 +374,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -381,7 +394,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -389,6 +402,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-41: USE CASE NAME ### UC-41: USE CASE NAME
**Summary:** **Summary:**
@ -411,7 +425,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -431,7 +445,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -439,6 +453,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-42: USE CASE NAME ### UC-42: USE CASE NAME
**Summary:** **Summary:**
@ -461,7 +476,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -481,7 +496,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -489,6 +504,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-50: USE CASE NAME ### UC-50: USE CASE NAME
**Summary:** **Summary:**
@ -511,7 +527,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -531,7 +547,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -539,6 +555,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-51: USE CASE NAME ### UC-51: USE CASE NAME
**Summary:** **Summary:**
@ -561,7 +578,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -581,7 +598,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -589,6 +606,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-52: USE CASE NAME ### UC-52: USE CASE NAME
**Summary:** **Summary:**
@ -611,7 +629,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -631,7 +649,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -639,6 +657,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-60: USE CASE NAME ### UC-60: USE CASE NAME
**Summary:** **Summary:**
@ -661,7 +680,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -681,7 +700,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -689,6 +708,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-61: USE CASE NAME ### UC-61: USE CASE NAME
**Summary:** **Summary:**
@ -711,7 +731,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -731,7 +751,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -739,6 +759,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-62: USE CASE NAME ### UC-62: USE CASE NAME
**Summary:** **Summary:**
@ -761,7 +782,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -781,7 +802,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -789,6 +810,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-70: USE CASE NAME ### UC-70: USE CASE NAME
**Summary:** **Summary:**
@ -811,7 +833,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -831,7 +853,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -839,6 +861,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-71: USE CASE NAME ### UC-71: USE CASE NAME
**Summary:** **Summary:**
@ -861,7 +884,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -881,7 +904,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -889,6 +912,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-72: USE CASE NAME ### UC-72: USE CASE NAME
**Summary:** **Summary:**
@ -911,7 +935,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -931,7 +955,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -939,6 +963,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-80: USE CASE NAME ### UC-80: USE CASE NAME
**Summary:** **Summary:**
@ -961,7 +986,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -981,7 +1006,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -989,6 +1014,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-81: USE CASE NAME ### UC-81: USE CASE NAME
**Summary:** **Summary:**
@ -1011,7 +1037,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -1031,7 +1057,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -1039,6 +1065,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-82: USE CASE NAME ### UC-82: USE CASE NAME
**Summary:** **Summary:**
@ -1061,7 +1088,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -1081,7 +1108,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -1089,6 +1116,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-90: USE CASE NAME ### UC-90: USE CASE NAME
**Summary:** **Summary:**
@ -1111,7 +1139,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -1131,7 +1159,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE
@ -1139,6 +1167,7 @@ cases first and come back to less important ones later.*
- ::QUESTION - ::QUESTION
--- ---
### UC-91: USE CASE NAME ### UC-91: USE CASE NAME
**Summary:** **Summary:**
@ -1161,7 +1190,7 @@ cases first and come back to less important ones later.*
::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER ::STAKEHOLDER, STAKEHOLDER, STAKEHOLDER
**Prereq:** **Prerequisite:**
- ::PRECONDITION - ::PRECONDITION
- ::PRECONDITION - ::PRECONDITION
@ -1181,7 +1210,7 @@ cases first and come back to less important ones later.*
- ::If CONDITION, then ALTERNATIVE STEPS. - ::If CONDITION, then ALTERNATIVE STEPS.
- ::NOTES or DETAILS. - ::NOTES or DETAILS.
**Notes and Questions** **Notes and Questions:**
- ::NOTE - ::NOTE
- ::NOTE - ::NOTE

12
User-Guide.md
View File

@ -2,16 +2,20 @@
**product** name and **external** release number, not internal **product** name and **external** release number, not internal
information.* information.*
##### Product: ##### Product
::[PRODUCT-NAME](http://www.COMPANY.com/products/PRODUCT-NAME/) ::[PRODUCT-NAME](http://www.COMPANY.com/products/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/PRODUCT-NAME/) or email [website](http://www.COMPANY.com/products/PRODUCT-NAME/) or email
us at <support@COMPANY.com> us at <support@COMPANY.com>

31
User-Needs.md
View File

@ -1,13 +1,17 @@
##### Project ##### Project
::[PROJECT-NAME](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)
--- ---
**Process impact:** The statement of user needs documents and explains **Process impact:** The statement of user needs documents and explains
@ -59,6 +63,7 @@ fun with the least effort. This website must be familiar to players
who have used other sites, but it must also be better. who have used other sites, but it must also be better.
#### What is the system's physical environment? #### What is the system's physical environment?
:: This system is a web server that will run on a machine in a :: This system is a web server that will run on a machine in a
co-located data center with 24x7 monitoring, UPS, co-located data center with 24x7 monitoring, UPS,
air-conditioning, etc. Users of this system are typically at air-conditioning, etc. Users of this system are typically at
@ -154,18 +159,23 @@ communication took place via email, link to it in the archive or paste
it here.* it here.*
#### ::DATE, INTERVIEWEE #### ::DATE, INTERVIEWEE
::[interview with INTERVIEWEE](interview-notes.html) ::[interview with INTERVIEWEE](interview-notes.html)
#### ::DATE, INTERVIEWEE #### ::DATE-1, INTERVIEWEE
::NOTES FROM INTERVIEW...(pasted here) ::NOTES FROM INTERVIEW...(pasted here)
#### ::DATE, INTERVIEWEE #### ::DATE-2, INTERVIEWEE
::NOTES FROM INTERVIEW...(pasted here) ::NOTES FROM INTERVIEW...(pasted here)
#### ::DATE, PARTICIPANTS #### ::DATE-3, PARTICIPANTS
::NOTES FROM BRAINSTORMING SESSION...(pasted here) ::NOTES FROM BRAINSTORMING SESSION...(pasted here)
#### ::DATE, PARTICIPANTS #### ::DATE-4, PARTICIPANTS
::[email from INTERVIEWEE](LINK-TO-ARCHIVE) ::[email from INTERVIEWEE](LINK-TO-ARCHIVE)
### User Stories ### User Stories
@ -179,6 +189,7 @@ assumptions about details of the system, instead focus on the users.
Note the source of each user story.* Note the source of each user story.*
#### ::invited-to-join #### ::invited-to-join
:: John has gotten pretty good at SuperShooter by playing on public :: John has gotten pretty good at SuperShooter by playing on public
servers about 8 hours a week for the last 3 weeks. John has chatted servers about 8 hours a week for the last 3 weeks. John has chatted
with Bob about strategies and they have enjoyed some duels. Bob is a with Bob about strategies and they have enjoyed some duels. Bob is a
@ -187,18 +198,22 @@ private server Friday nights. Bob invites John to visit the RedDawn
website and join. (Source: [INTERVIEWEE](interview-notes.html)) website and join. (Source: [INTERVIEWEE](interview-notes.html))
#### finding-the-tournament #### finding-the-tournament
:: 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: PERSON-NAME) clan website to find that information. (Source: PERSON-NAME)
#### STORYNAME1 #### STORY-NAME-1
:: PARAGRAPH :: PARAGRAPH
#### STORYNAME2 #### STORY-NAME-2
:: PARAGRAPH :: PARAGRAPH
#### STORYNAME3 #### STORY-NAME-3
:: PARAGRAPH :: PARAGRAPH
### Performance and Capacity Needs ### Performance and Capacity Needs

6
Workflows.md
View File

@ -1,4 +1,5 @@
### By Activity ### By Activity
1. Project Planning 1. Project Planning
1. [Home](Home) 1. [Home](Home)
2. [Proposal](Proposal) 2. [Proposal](Proposal)
@ -40,6 +41,7 @@
4. [Software Development Methodology](SDM) 4. [Software Development Methodology](SDM)
### By Suggested Sequence ### By Suggested Sequence
1. Step 1 1. Step 1
1. [Home](Home) 1. [Home](Home)
2. [Proposal](Proposal) 2. [Proposal](Proposal)
@ -82,6 +84,7 @@
1. [Status Report](Status-Report) 1. [Status Report](Status-Report)
### All Templates ### All Templates
1. [Summary](Summary) 1. [Summary](Summary)
2. [Home](Home) 2. [Home](Home)
3. [Proposal](Proposal) 3. [Proposal](Proposal)
@ -116,7 +119,8 @@
18. [Status Report](Status-Report) 18. [Status Report](Status-Report)
19. [Software Development Methodology](SDM) 19. [Software Development Methodology](SDM)
### How to download these templates: ### How to download these templates
- [Download template archive](http://readyset.tigris.org/servlets/ProjectDocumentList), or - [Download template archive](http://readyset.tigris.org/servlets/ProjectDocumentList), or
- Use CVS to [check out](http://readyset.tigris.org/servlets/ProjectSource) project - Use CVS to [check out](http://readyset.tigris.org/servlets/ProjectSource) project
"readyset" or clone from [ReadySet GFM](https://github.com/bike-bill/readyset-gfm.wiki.git) "readyset" or clone from [ReadySet GFM](https://github.com/bike-bill/readyset-gfm.wiki.git)